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Aggiorna il BLOG con il 

CELLULARE 



Scrivi un'applicazione J2ME ed invia 
le news sul web in ogni momento 
e da qualunque parte del mondo 

USERIUAME E PASSWORD 

salvali in un "portachiavi" 

per non doverli riscrivere ogni volta 

SCRITTURA E UPLOAD 

memorizza i post localmente per 
inviarli tutti insieme in un colpo solo 

DOWNLOAD E LETTURA 

sincronizza i dati locali con quelli 
remoti ogni volta che ti connetti 

GESTIONE DEL SERVER 

modifica il tuo sito PHP per gestire 
le richieste provenienti dal telefonino 





FATTI IL GADGET 

VISTA 



II 



Arrivano le "miniapplicazioni" residenti sul desktop. 
Ecco come crearne una che ti mostra costantemente 
lo spazio disponibile e occupato sul tuo Hard Disk 



E-COMMERCE 

CON DRAG & DROP 

Usa Ajax e metti un prodotto nel carrello 
semplicemente trascinandolo sulla sua icona 



SISTEMA 



DALLE INTERFACCE Al 
DATABASE CON JYTHOM 

Arriva il linguaggio che fonde insieme Python 
e Java, ecco come funziona 



AUTOMI CELLULARI E GIOCO DELLA VITA 



algoritmi per simulare la diffusione di un fenomeno 



MA QUANTE VISITE 
HA IL MIO SITO? 

Scoprilo analizzando 
direttamente i LOG di US ed 
elaborando grafici statistici 

SITI MULTILINGUA 
CON STRUTS 2 

Localizza i tuoi contenuti con 
il framework Java per il Web 
più usato al mondo 

USA JAVASCRIPT 
DA OGNI DOMINIO 

Ecco come utilizzare anche 
gli script presenti su un sito 
esterno al tuo 



PATTERN 



LADAPTER METTE 
TUTTI D'ACCORDO 

Prendi pezzi di codice da 
Internet e falli comunicare 
insieme con questo pattern 



GESTIRE LE STRINGHE 
IN MODO SICURO 

Metti al riparo i tuoi programmi 
dai possibili attacchi degli hacker 



NUOVI 







WINDQIVSPRB 



MOBILE 



USA AJAX NEI 
DISPOSITIVI MOBILI 

Progetta siti pronti per il Web 
2.0 e compatibili con cellulari e 
smartphone 

UN SMS SERVER CON 
WINDOWS MOBILE 

Il tuo Pocket PC reagisce ai 
messaggi in arrivo e si comporta 
come vuoi tu 
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versamento insieme alla 



t "SLOW" PROGRAMMING 



La novità più importante del mese è quella relativa al- 
l'annuncio dei piani di sviluppo per Symbian OS. La 
nuova versione del sistema operativo più diffuso per i 
sistemi embedded è prevista per il 2009. La direzione 
intrapresa è quella della diminuizione delle richieste 
hardware, un miglior supporto alVOIB l'inserimento 
di funzioni relative allo streaming multimediale an- 
che dalla rete, in altre parole TV Over IE 
Non possiamo non fare qualche considerazione ri- 
spetto a questo annuncio, non tanto nel merito della 
notizia, quanto sulle indicazioni generali rispetto alla 
programmazione che scaturiscono dai suoi contenu- 
ti. Prima di tutto: i tempi. Il piano di sviluppo viene 
annunciato a 2 anni di distanza dalla data di rilascio. 
Due anni rappresentano un'eternità in materia di 
programmazione e di informatica in generale o alme- 
no la rappresentano rispetto alle comuni abitudini 
dei nostri clienti. Chiedere due anni di sviluppo per 



un progetto equivarrebbe per noi a perdere la com- 
messa, mentre rappresentano un tempo "normale" 
per una casa come Symbian. L'attenzione alla dimi- 
nuizione delle richieste hardware. Anche in questo 
caso per noi non rappresenterebbe un problema. E 
infine la lungimiranza verso tecnologie che attual- 
mente sono già diffuse ma che si prevede saranno di 
uso comune proprio in un tempo informatico abba- 
stanza lungo. Tutto questo ci deve far riflettere su 
quanto la programmazione abbia necessità di tornare 
ad una dimensione più umana, dove il tempo di svi- 
luppo è commisurato alle necessità del cliente ma an- 
che alle reali difficoltà del progetto. Non sempre ag- 
giungere una nuova risorsa significa diminuire il tem- 
po di sviluppo. In conclusione è importante nel corso 
dei nostri progetti aumentare lo spazio riferito all'a- 
nalisi, ai requisiti e alla gestione delle risorse, solo così 
riusciremo a tirar fuori progetti efficienti. 



c? — z? — 

LI CD Li WEB 




All'inizio di ogni articolo, troverete un simbolo 
che indicherà la presenza di codice e/o software 
allegato, che saranno presenti sia sul CD (nella 
posizione di sempre \soft\codice\ e \soft\tools\) 
sia sul Web, all'indirizzo 
http://cdrom.ioprogrammo.it. 



do la Vs. autorizzazione, il numero di carta di credito, la data di scaden- 
za, l'intestatario della carta e il codice CW2, cioè le ultime 3 cifre del 

). 
• bonifico bancario intestato a Edizioni Master S.pA c/o BCC MEDI0C- 
RATI S.CAR.L. c/c 000 000 12000 ABI 07062 CAB 80880 CIN P (invian- 
do copia della distinta insieme alla richiesta). 

SI PREGA DI UTILIZZARE IL MODULO RICHIESTA ABBONAMENTO POSTO 
NELLE PAGINE INTERNE DELLA RIVISTA. L'abbonamento verrà attivato sul 
primo numero utile, successivo alla data della richiesta. 

nuli difetti o ir 
zioni che ne limitassero la fruizione da parte dell'utente, è prevista 



La sostituzione sarà effettuata se il problema sarà riscontrato e 
segnalato entro e non oltre 10 giorni dalla data effettiva di acquisto 
Ml ~ udita f J " ' ■-*■■■-■'■■-■■ 
postale di restituzione del materiale. 

ire il CD-Rom difettoso in busta chiusa a: 

Edizioni Master - Servizio Clienti - Via C. Conenti, 1 - 20123 Milano 

Servizio Abbonati: 

(■tei. 02 831212 1 



r |i ^f¥"!ffw | w™!'T"?"" 



Stampa: Arti Grafiche Boccia S.p.a. Via Tiberio Felice, 7 Salerno 

■ (CS) 



Vìa Vitorchiano, 81 - Roma 



KMT)MM.i 



allegato alla rivista e/o per eventuali anomalie degli stessi. Nessuna 
responsabilità è, inoltre, assunta dalla Edizioni Master per danni o altro 

derivanti da virus informatici non riconosciuti dagli antivirus ufficiali 

all'atto della masterizzazione del supporto. Nomi e marchi protetti sono 

citati senza indicare i relativi brevetti. 



Anno di Linux Manzine in DVD 2006, 1 Anno di 
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Grandi Giochi per Pc, I Libri di Quale 
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AGGIORNA IL BLOG CON IL 

CELLULARE 

Scrivi un'applicazione J2ME ed invia le news 
sul Web in ogni momento e da 
qualunque parte del mondo 

Username e Password 

salvali in un "portachiavi" 

per non doverli riscrivere ogni volta 



Scrittura e Upload 

memorizza i post localmente per 
inviarli tutti insieme in un colpo solo 



Download e Lettura 

sincronizza i dati locali con quelli 
remoti ogni volta che ti connetti 



Gestione del server 

modifica il tuo sito PHP per gestire 
le richieste provenienti dal telefonino 



IT^i^i 




004-005 editoriale 30-03-2007 14:23 Pagina 5 



Questo mese su ioProgrammo 



FATTI IL GADGET 
PER WINDOWS VISTA 

Arrivano le "miniapplicazioni" residenti sul desktop. Ecco come crearne una 
che ti mostra costantemente lo spazio disponibile e occupato sul tuo Hard Disk 

pag. 24 




RAMMOWEB 



Usare Ajax 

nei dispositivi mobili pag. 32 

L'ultima moda nell'ambito dello sviluppo 
di applicazioni Web è sicuramente Ajax. 
Impariamo ad utilizzare questa tecnologia 
innovativa anche nei browser dei cellu- 
lari, che tipicamente impongono qualche 
restrizione... 

Ma quante visite 

ha il mio sito pag. 42 

Impariamo a sfruttare il formato dei log 
di iis importando i dati in una nostra 
applicazione e realizzando un completo 
sistema di gestione delle statistiche, per 
farlo sfrutteremo anche ssis... 

Una soluzione Ajax 

per il Drag & Drop pag. 53 

Impareremo come creare un carrello della 
spesa che accetta i prodotti semplice- 
mente per trascinamento, per imple- 
mentare il tutto sarà sufficiente qualche 
riga di Javascript e un pò di HTML avan- 
zato 

Javascript 

Cross-Domain pag. 56 

In questo articolo impareremo ad utiliz- 
zare Javascript per effettuare chiamate 
asincrone ad un dominio diverso da quel- 
lo di appartenenza. Come vedremo, ques- 
ta tecnica ci permetterà di spostare il cari- 
co di lavoro dal server al client 



ANTEPRIMA 



JYthon: fonde 
Python con Java 

pag. 62 

Ecco come raccogliere in un 
unico linguaggio la 
completezza del 
compilatore di Sun con 
l'eleganza e la semplicità di 
Python. In questo numero 
realizzeremo esempi 
complessi con pochissime 
righe di codice 



MOBILE 



L'SMS che comanda 

il tuo cellulare pag. 70 

Impariamo come configurare un cellulare, 
sincronizzare la rubrica degli appunta- 
menti, aggiungere un contatto e molto 
altro ancora semplicemente inviantogli 
un breve messaggio di testo remoto 



SISTEMA 



Localizzare servizi 

Web con Struts 2 pag. 78 

Impariamo come realizzare applicazioni 
multilingua utilizzando il Framework di 
sviluppo per Pattern MVC più conosciuto 
al mondo. Non solo otterremo software 
affidabile ma anche facilmente dis- 
tribuibile 

Programmare OO 

con "sani principi" pag. 89 

Impareremo come scrivere software puli- 
to, facilmente manutenibile e docu- 
mentabile. Vedremo come alcune sempli- 
ci regole di buona programmazione pos- 
sono aiutarci enormemente nello svilup- 
po 

Gestiamo in modo sicuro 

le stringhe pag. 96 

Nel 1989 il comitato ANSI ammise che se 
C++ non avesse avuto un buon supporto 



RUBRICHE 



Gli allegati di ioProgrammo 

pag. 10 
// software in allegato alla rivista 

Il libro di ioProgrammo 

pag. 8 

// contenuto del libro in allegato 
alla rivista 

News pag. 12 

Le più importanti novità del 
mondo della programmazione 

Tips & Tricks pag. 82 

Una raccolta di trucchi da tenere a 
portata di... mouse 

Software pag. 108 

/ contenuti del CD allegato ad 
ioProgrammo. 



nativo per le stringhe sarebbe "corso del 
sangue per le strade". Come e quanto 
funzionano gli oggetti string, oggi? 



PATTERN 



L'adapter: mette 

tutti d'accordo pag. 102 

/ migliori programmatori lavorano spesso 
assemblando librerie e frammenti di 
codice scaricati da Internet, di solito que- 
sti pezzi non sono pensati per funzionare 
insieme. Ma per fortuna, c'è modo di 
risolvere il problema 



SOLUZIONI 



Automi cellulari: 
il gioco della vita 

pag. 111 

Tra gli automi cellulari, il 
più noto è probabilmente il 
gioco della vita. Un 
semplice e ben strutturato 
esempio di sistema auto- 
organizzato utile per 
comprendere molti 
fenomeni anche naturali 



QUALCHE CONSIGLIO UTILE 

I nostri articoli si sforzano di essere 
comprensibili a tutti coloro che ci 
seguono. Nel caso in cui abbiate 
difficoltà nel comprendere 
esattamente il senso di una 
spiegazione tecnica, è utile aprire il 
codice allegato all'articolo e 
seguire passo passo quanto viene 
spiegato tenendo d'occhio l'intero 
progetto. Spesso per questioni di 
spazio non possiamo inserire il 
codice nella sua interezza nel corpo 
dell'articolo. Ci limitiamo a inserire 
le parti necessarie alla stretta 
comprensione della tecnica. 
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Strivi un'applicazione J2ME ed invia 
e da qualunque parte del mondo 



la ■' ir m ■■" 

Aggiorna il BLOG con j 

CELLULARE 



MA QUANTE VISITE 
HA IL MIO SITO? 



salvali in un "portachiavi . 
fS non doverli riscrivere ogni vofta 

SCRITTURA E UPLOAD 

memorila I post l»» lme,,,e l ìl f snlD 
inviarli tutti Insieme m un colpo solo 



sincronia* I dati locali cor, quelli 
temoli ogni volta che ti corineti. 

GESTIONE DEL SHWE" 

modifica il tuo sito PHP per gestire 
^ctiite provenienti dal telefonino 




dir*tt*nnP*v|PÌLMrSirSrf 
Elébjratxlg granii nitìnitt 
SITI MULTILINGUA 
CON STWJTS 2 

oliK^iplp^«fltl"JU" ,llo 



l'ADAPTEH METTE 

TUTTI D' ACCORDO 

ìtftrm <M> opta* prttfm 

GESTIRE LE STRINSI » 
SfSotiO SICURO ì 

y ralJ l„p.n>i™-.pras^ 
tìi tumulili KtMcW «di' "»^ 



RIVISTA + LIBRO 
+ CD-ROM 

in edicola 




gassai». 






*%S^STA 

- ir residenti sul desktop. 
n +V* -^an f wmntanente 




I contenuti del libro 



Lavorare con Java 6 



Java festeggia più di 1 anni di vita. Nel tempo è 
diventato un linguaggio dalla complessità enorme, 
completato da un ecosistema di librerie veramente 
imponente. 

Al contempo la sua diffusione ha raggiunto vette 
decisamente importanti. Va da se che ogni nuova versione è 
accompagnata da problemi di retrocompatibilità ma anche 
foriera di importanti novità, che la rendono aderente agli 
sviluppi che i sistemi operativi e più in generale l'informatica 
attraversano nel corso del tempo. 
In questo libro Ivan Venuti, non solo mostra un approccio 
decisamente pratico alla risoluzione di problemi di 
programmazione giornalieri, ma illustra come le nuove 
funzionalità di Java 6 possano decisamente innalzare la 
produttività di ogni sviluppatore. Si tratta di un HandBook 
veloce, pratico, essenziale che consente un viaggio pratico e 
divertente nell'universo Java 



PER SFRUTTARE A FONDO TUTTE LE 
CARATTERISTICHE DELLA NUOVA 
VERSIONE DEL LINGUAGGIO DI SUN 

• Installazione e novità 

• applicazioni 
Desktop & Grafica 

• Database & Scripting 
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Online con Tiscali Easy 

Numero unico per tutta l'Italia e nessuna registrazione. Il modo 
più semplice e veloce per entrare in Internet risparmiando 



Sei spesso lontano da casa e hai necessità di 
collegarti a Internet ovunque ti trovi? 
Desideri salvaguardare la tua privacy navigan- 
do in modo anonimo? Non hai voglia di perde- 
re tempo in lunghe registrazioni per creare un 
nuovo account? Niente paura, Tiscali ha pensa- 
to anche a te! Con Tiscali Easy arriva un siste- 
ma tutto nuovo di collegarsi a Internet. Non 
sarà più necessario creare un nuovo account e 
fornire i propri dati personali, potrai navigare 
collegandoti con un unico numero di telefono 
(7023456789) da tutta Italia e soprattutto utiliz- 
zando i dati di accesso forniti direttamente da 
Tiscali (UserID e Password presenti sulla sche- 
da), quindi non collegabili in alcun modo a te. 
Insomma, con Tiscali Easy, otterrai in un colpo 
solo riservatezza dei dati, risparmio del tempo 
necessario alla creazione di un abbonamento e 
tariffe vantaggiose. I costi di connessione sono 
simili a quelli di un classico abbonamento gra- 
tuito: 1,90 cent, per i primi 10 minuti e 1,72 
cent, per quelli successivi. Per risparmiare 
ulteriormente è possibile connettersi a 
Internet durante le ore serali o nei giorni festi- 



TISCALI EASY 

C'è un modo nuovo, semplice e veloce per entrare in Internet. Provalo subito! 




DI SCONTO 
AGGIUNTIVI 



30€. 

gassssnss 



Crea una nuova connessione inserendo il numero 
unico di accesso da tutta Italia 7023456789 

Avvia la connessione e digita i seguenti codici: 
UserID master2007 
Password tiscali 

Grazie per aver scelto Tiscali 
e buona navigazione! 

Costi di connessione disponibili su tiscali.it 
Servizio Assistenza dedicato 892130 



tiscali* 



vi al costo di 1,09 cent, per i primi dieci minuti 
e 0,98 cent, per quelli successivi. L'unico requi- 
sito richiesto per poter eseguire la connessione 
è un modem correttamente installato. Poiché 
si tratta di una normale connessione analogica 
è possibile utilizzare i tool di accesso remoto 
integrati in Windows 



IN RETE CON TISCALI 

Nessuna registrazione basta creare una nuova connessione e inserire 
i dati di accesso forniti da Tiscali 




File Modifica Visualizza Preferiti strumenti Avanzate ? 
^Indietro * _l ^p Cerca' [£> Cartelle [77!] - 
'■■' : " : ' .v **T Connessioni di rete 




sm. 



LAN a Internet ad alti, velocità 



H Connessior 



^ Installa una rete domes tica a | 

una piccola rete sSer : | Awia la Cre 
Igl Modifica Impostazioni Win dot* 



.q 



Vedere anche 

i_; RivCiluziiiTie dei problemi di 



Altre ri 



1 VM-areNen.orr.Mi 

W5 | VMnetS 
ti! Jt Connesso. 



Q NUOVA CONNESSIONE 
Portiamoci nel pannello di con- 
trollo, e selezioniamo l'icona connes- 
sioni di rete. In alto a sinistra sele- 
zioniamo "nuova connessione" e 
prepariamoci a seguire il wizard che 
comparirà 



informaci 



Password: 
i"'o!'i f !ì!iTia password: 

■.'v/.M: ■.';■.■::.« ■•■"":: ■:■■ •!.•■■.■■:■■:■■■■' ■ : ■ ■ . ■■ , .■ ■! :.| ! 

Imposta questa annessione nternei come predefinita 



; < Indietro jj Avanti > | [ Annulla ] 




HDATI DI ACCESSO 
Seguiamo il Wizard fino a 
quando non ci vengono chiesti i 
dati per l'autenticazione. E' suffi- 
ciente inserire quelli presenti nella 
card allegata a questo numero di 
ioProgrammo: master2007/tiscali 



H ACCESSO A INTERNET 
Connettersi è semplicissimo, 
troveremo una nuova icona all'in- 
terno del pannello di controllo alla 
voce connessioni. Bastano due click 
ed il gioco è fatto sarete connessi 
ovunque vi troviate 
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viglili in im "pm"^"" . __,„ 



Aaaiorna il BLOG con il smagar 

CELLULARE 




RIVISTA + CD-ROM 

in edicola 



VIRTUAL BOX 1.3.8 

Il virtualizzatore Free 

La virtualizzazione è 
l'ultima frontiera. La 
nutrita schiera di 
sistemi operativi con 
le relative versioni, 
rende particolarmen- 
te complesso lo svi- 
luppare programmi 
in grado di funziona- 
re sui vari sistemi 
senza problemi. Per 
questo ogni pro- 
grammatore tende a 
testare le proprie 
applicazioni su più sistemi. E' ovviamente quasi 
impossibile disporre di tante macchine per quanti 
sono i sistemi operativi così ci vengono in aiuto i 
software di virtualizzazione che emulano il compor- 
tamento di una macchina via software. VirtualBox è 
uno di questi. E' recente, è molto leggero ed è free. 

Directory :/VirtualBox 1.3.8 Win x86.msi 




Prodotti del mese 



Crystal Space 1.0 

Il re c'è ancora 

È stato per lungo tempo il domi- 
natore delle scene per quanto 
riguarda gli Engine 3D. Lo è stato 
almeno fino all'avvento di Irrlicht 
e del più recente XNA. Questo 
non vuol dire che non rappresen- 
ti ancora lo stato dell'arte nel 
campo della programmazione 
dei videogiochi. Ad oggi si tratta 
di uno degli engine 3D che conta 
il maggior numero di installazio- 
ni e giochi sviluppati. In questo 
numero vi presentiamo la release 
1.0 di cui purtroppo sono dispo- 
nibili solo i sorgenti. Tuttavia la 
compilazione non è un'operazio- 
ne complicata e vi mette in grado 
di conoscere ancora meglio il 
prodotto su cui state lavorando. 
Il framework è piuttosto veloce e 
si possono ottenere effetti 
straordinari con uno sforzo mini- 
mo. Non per niente Crystal Space 
è stato per lungo tempo il più 
diffuso. 

[pag.106] 




Zend 
Framework 0.9 

L'SDK evoluto per PHP 

Chi sviluppa in PHP è abituato a 
sviluppare in maniera autonoma 
il proprio framework, partendo 
dalle proprie esperienze e neces- 
sità. Questo ha però dato origi- 
ne ad un ecosistema di applica- 
zioni spesso difficilmente manu- 
tenibile. Zend ha sviluppato un 
proprio Framework completo 
che dispone di una serie di mec- 
canismi che velocizzano la riso- 
luzione dei problemi più fre- 
quenti. Si va dall'implementa- 
zione del pattern MVC alla crea- 
zione dei Web Services, alla 
gestione delle stampe in PDF. Si 
tratta di un framework piuttosto 
affidabile essendo sviluppato da 
Zend che è anche la software 
house promotrice dello sviluppo 
di PHP. Si tratta di un modo 
innovativo di guardare a PHP, 
che fino ad ora non prevedeva 
un framework unitario 
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Struts 2.0.1 

// framework MVC per Java 

Il pattern MVC è probabilmente il 
più usato da tutti gli sviluppatori in 
ogni linguaggio.Questo framework 
è il leader per quanto riguarda lo svi- 
luppo di applicazioni Java secondo 
il pattern MVC. Molto comodo, sta- 
bile e affidabile, rappresenta la ba- 
se di partenza per applicazioni che 
devono essere facilmente manute- 
nibili. Uno standard da usare se pro- 
gettate applicazioni di dimensioni 
generose, ma anche quando si svi- 
luppano web application professio- 
nali. Non si tratta sicuramente di un- 
framework facile da usare, non per 
niente in queste pagine vi dedichia- 
mo spesso approfondimenti, ma è 
anche vero che una volta appresa la 
logica di funzionamento, la tipolo- 
gia di applicazioni risultante appa- 
re realmente solida. La difficoltà sta 
tutta nella curva di apprendimento, 
una volta superato il gradino inizia- 
le tutto risulta sufficientemente omo- 
geneo 

[pag.109] 



StrutS 


gK~— __^_*_ m — 


" ~ j 


?2C,r- ^~ 


& ! 

■ 

■ 
1 
■ 


-===-- - : = = 






— - " ■ 


■ 
■ 


3 . — z jzz z 


__ __, — l 


— =■ * — 



Irrlicht 1.2 

Accendi il migliore motore 30 
Open Source! 

Irrlicht è un motore per la grafica 
tridimensionale, scritto in C++ e 
utilizzabile sia con questo lin- 
guaggio, sia con la tecnologia 
.NET.Presenta le principali caratte- 
ristiche di un motore professiona- 
le e vanta una notevole comunità 
di sviluppatori, con diversi pro- 
getti in attivo. Irrlicht ha tra i suoi 
pregi anche quello di potere uti- 
lizzare sia DirectX che Open GÌ per 
cui diventa particolarmente adat- 
to anche per lo sviluppo di giochi 
multipiattaforma. Nel tempo 
Irrlicht ha assunto dimensioni par- 
ticolamente rilevanti fino a diven- 
tare quasi uno standard per chi 
sviluppa VideoGames. I suoi con- 
notati essenziali sono la curva di 
apprendimento molto rapida e la 
completezza delle funzionalità 
esposte, che consentono una fles- 
sibilità rara in questo mercato 
[pag.106] 
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GLI ALLEGATI DI IO PROGRAMMO 

Questo mese tre Webcast per comprendere le novità 
incluse nell'ambiente grafico di Windows Vista 



Windows Presentation Foundation - WPF 



WPF è il nuovo ambiente gra- 
fico di Windows Vista e .NET 
Framework 3.0. Il percorso 
formativo inizia con un'in- 
troduzione all'ambiente e al- 
le sue caratteristiche princi- 
pali, per poi entrare nel det- 
taglio con esempi semplici di 
binding di proprietà fino a 
esempi complessi come Ma- 
ster/Detail binding. Si par- 
lerà di compatibilità con il 




passato, migrazione dell'esi- 
stente e interoperabilità con 
il futuro (tecnologia deno- 
minata "CrossBow"). Verrà 
poi analizzato il lato web- 
oriented di WPF con le Ex- 
press Application, applica- 
zioni capaci di essere ospita- 
te all'interno di Internet Ex- 
plorer per estendere le pos- 
sibilità delle user interface 
del futuro. Brevi cenni su 
WPF/E (WPF 

Everywhere) chiu- 
dono la serie. Si trat- 
ta di tre Webcast che 
ti portano diretta- 
mente al cuore del 
nuovo sistema. In- 
dispensabili per 
creare applicazio- 
ni innovative. 



lu 



PERCORSI 
FORMATIVI 

Per chi desiderasse approfondire 
sono disponibili sul sito di 
Microsoft una serie di strumenti 
dedicati ad approfondire le 
novità di Windows Vista 

Windows Vista e .NET Framework 
3.0: overview «Windows 
Communication Foundation - 
WCF • Windows Workf low 
Foundation • Windows Workflow 
Foundation - Security & pri- 
vacy • Internet Explorer 7 • 
Architettura del sistema operati- 
vo • Developing Gadgets for 
Windows Toolbar • Come testare 
la compatibilità delle proprie 
applicazioni 

Visita 

http://www.microsoft.com/italy/ 

msdn/risorsemsdn/windowsvista/ 

default.mspx 



FAQ 



Cosa sono i Webcast MSDN? 

MSDN propone agli sviluppatori una serie di eventi gratuiti 
online e interattivi che approfondiscono le principali temati- 
che relative allo sviluppo di applicazioni su tecnologia 
Microsoft. Questa serie di "corsi" sono noti con il nome di 
Webcast MSDN 

Come è composto tipicamente un Webcast? 

Normalmente vengono illustrate una serie di Slide commenta- 
te da un relatore. A supporto di queste presentazioni vengono 
inserite delle Demo in presa diretta che mostrano dal vivo 
come usare gli strumenti oggetto del Webcast 

Come mai trovo riferimenti a chat o a strumenti 
che non ho disponibili nei Webcast allegati alla 
rivista? 

La natura dei Webcast è quella di essere seguiti OnLine in 
tempo reale. Durante queste presentazioni in diretta vengono 
utilizzati strumenti molto simili a quelli della formazione a 
distanza. In questa ottica è possibile porre domande in presa 
diretta al relatore oppure partecipare a sondaggi etc. I 
Webcast riprodotti nel CD di ioProgrammo, pur non perdendo 



nessun contenuto informativo, per la natura asincrona del sup- 
porto non possono godere dell'interazione diretta con il rela- 
tore. 

Come mai trovo i Webcast su ioProgrammo 

Come sempre ioProgrammo cerca di fornire un servizio ai pro- 
grammatori italiani. Abbiamo pensato che poter usufruire dei 
Webcast MSDN direttamente da CD rappresentasse un ottimo 
modo di formarsi comodamente a casa e nei tempi desiderati. 
Lo scopo tanto di ioProgrammo, quanto di Microsoft è infatti 
quello di supportare la comunità dei programmatori italiani 
con tutti gli strumenti possibili. 

Su ioProgrammo troverò tutti Webcast 
di Microsoft? 

Ne troverai sicuramente una buona parte, tuttavia per loro 
natura i webcast di Microsoft vengono diffusi anche OnLine e 
possono essere seguiti previa iscrizione. L'indirizzo per saperne 
di più è: http://www.microsoft.it/msdn/webcast/msdn segnalo 
nei tuoi bookmark. Non puoi mancare. 

L'iniziativa sarà ripetuta sui prossimi numeri? 

Sicuramente si. 
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CODICE APERTO 
PER VISUAL 
FOX PRO 

'stato uno dei cavalli di battaglia di 
i Microsoft per molto tempo ma, dopo 
averne cessato lo sviluppo, l'azienda di 
Redmond conferma adesso di volerne 
rendere disponibile il codice sorgente. Il 
passo appare logico, visto e considera- 
to che il prodotto vanta comunque una 
larga base di utilizzatori. In questo mo- 
do si affida alla community ogni succes- 
sivo sviluppo di Visual Fox Pro. In parti- 
colare il codice sorgente sarà rilasciato 
sul sito di CodePlex, comprensivo delle mo- 
difiche fin qui apportate e che dovevano 
costituire la base per il nuovo Visual Fox- 
Pro 10. A garanzia della volontà di MS 
di non lasciare abbandonata a se stessa 
la community degli utilizzatori, in ogni ca- 
so l'azienda di Bill Gates ne garantirà il 
supporto fino al 2010. Il team che fino 
ad ora si è occupato di FoxPro sarà in- 
vece dirottato sullo sviluppo del prossi- 
mo Visual Studio, nome in codice Orcas 



Visual FoxPro 8.0 

Professi " 81 



ADDIO BACKUS 

~" er quelli che non lo conoscessero John 
W. Backus è considerato il padre di 
Fortran, il linguaggio che nel 1957 fu 
considerato una rivoluzione nel mondo 
degli sviluppatori. Backus si è spento al- 
l'età di 82 anni, ed è sorprendente quan- 
to, nonostante il Fortran sia ormai un 
linguaggio relegato a pochi eletti, tut- 
tavia la morte di Backus abbia suscitato 
un sincero dolore rappresentato da un 
numero elevatissime di persone in rete. 
Backus per molti anni ha anche ricoper- 
to il ruolo di team leader in IBM e re- 
centemente stava continuando il suo la- 
voro alla ricerca di modi sempre nuovi 
di concepire un linguaggio di program- 



U scito da veramente pochissi- 
mo Vista è già oggetto di 
discussione. Si susseguono i dati 
di vendita e ognuno rappresenta 
una realtà diversa. Fra proclami di 
successo e delusioni, l'unica cosa 
certa è comunque che cominciano 
ad arrivare i primi fix di sicurezza. 
Non si tratta, in realtà di enormi 
problemi attualmente. Il primo 
bug è relativo a Windows Mail, il 
software che rimpiazza 
Outlook. Sotto determina- 
te condizioni sarebbe pos- 
sibile inviare ed eseguire 
un comando remoto sulla 
macchina attaccata. Il bug 
tuttavia non rappresenta 
un problema enorme, di 
fatto non è possibile passa- 
re argomenti ai comandi in 
esecuzione e soprattutto il 
comando in questione 
dovrebbe essere contenuto 
in una cartella dal nome I 



omonimo. Ovvio che la questione 
diventa piuttosto improbabile 
anche se non impossibile. L'altra 
debolezza, non può configurarsi 
come un problema di sicurezza, 
quanto invece come un bug nella 
programmazione del sistema. Pare 
infatti che su certi PC, muovendo 
o copiando determinati file si 
ottenga un rallentamento fuori 
controllo del sistema operativo 



E IL PARADISO 
PER FIREFOX 



Arriva la terza alpha del 
noto browser di Mozil- 
la Foundation, nome in co- 
dice questa volta: "Gran Pa- 
radiso". Si tratta ancora de- 
cisamente di una versione 
dedicata agli sviluppatori 
basata sul motore di rende- 
ring Gecko 1.9. La nuova 
versione di Firefox è piutto- 
sto attesa, il browser infatti 
nel tempo ha recuperato una 
posizione di rilievo nel mer- 
cato. Le modifiche di maggior 
spicco in questa terza alfa 
sono relative al supporto per 
le PNG animate, al suppor- 
to di alcuni attributi DOM 
come clientLeft e clientTop 
e alle modalità di caching 



dei dati. H passaggio alla nuo- 
va versione non è tuttavia 
indolore e come sempre ac- 
cade quando si parla di brow- 
ser potrebbero sussistere 
problemi di compatibilità 
con la visualizzazione delle 
pagine sviluppate per re- 
lease precedenti. D'altra 



parte Gecko si configura 
ormai come un motore af- 
fidabile a cui fa capo non 
solo Firefox ma tutta una 
serie di Browser che rap- 
presentanto un patrimo- 
nio enorme soprattutto per 
la crescente comunità de- 
gli utenti Linux. 
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SECUNIA ELEGGE 

IL SOFTWARE PIÙ SICURO 



La nota azienda danese che si occupa 
di sicurezza informatica ha appena re- 
so pubblico il rapporto 2006 sull'anda- 
mento delle vulnerabilità nei software più 
diffusi. Secondo questo rapporto i mag- 
giori exploit del 2006 devono essere cata- 
logati come "System Access" ovvero ex- 
ploit che coinvolgono gli amministratori di 
sistema, con un incremento di quasi il 25% 
rispetto all'anno precedente. Secondo lo stes- 
so rapporto il software che avrebbe sof- 
ferto delle maggiori vulnerabilità sarebbe 
stato Office XP, a seguire le altre versioni 
di Office 2000 e 2003. Quarto e quindo po- 
sto per Internet Explorer 6.0. 1 ae 5.0. 1 . Nel 
complesso le prime 12 posizioni della clas- 
sifica sarebbero occupate da software tar- 
gato Microsoft e solo al tredicesimo e quat- 
tordicesimo software comparirebbero Mo- 
zilla Firefox 1 .x e Novell Open Enterprise Ser- 
ver. 

Questa mole di informazioni ed il relati- 
vo contenuto non deve in realtà spaventare 
più di tanto. Appare ovvio che essendo i 
software targati Microsoft quelli tipica- 



mente più diffusi, è abbastanza giustifi- 
cato il fatto che siano anche quelli che su- 
biscono il maggior numero di attacchi e 
di conseguenza quelli che rilasciano più 
bug fix relativi alla security. Quello che in- 
vece deve far riflettere è il considerevole 
aumento della necessità di rilasciare bug 



fix per la sicurezza. Il dato dimostra la di- 
mensione che sta assumendo ormai il mer- 
cato clandestino degli attacchi informa- 
tici. Un mercato che deve preoccupare e de- 
ve essere fronteggiato con maggiore coor- 
dinazione non solo dagli sviluppatori ma 
anche dalle leggi dei vari governi. 
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Software nams 



CE ATTESA PER IL MUOVO SYMBIAN OS 



Arrivano le prime indiscre- 
zioni per la nuova versione di 
Symbian OS: la 9.5, prevista per 
il 2009. Prima di tutto la società 



sviluppatrice del sistema opera- 
tivo ha annunciato che saranno 
ancora diminuiti i requisiti 
hardware minimi necessari a fa- 




re girare il prodotto. Si attende 
una riduzione dal 20 al 30% del 
consumo di memoria, opera- 
zione che dovrebbe aumentare 
quasi del 75% la velocità d' avvio 
delle applicazioni. Allo stesso 
modo il minor consumo di me- 
moria dovrebbe aumentare no- 
tevolmente anche la durata del- 
le batterie. Dal punto di vista 
strettamente operativo si preve- 
de un maggior supporto la voice 
over IP e alla gestione del multi- 
media intesa anche come sup- 
porto a protocolli come DVB e 
ISDB-T. Infine c'è da segnalare 
il supporto nativo al database 
SQLLite, il che fa presupporre 
che la persistenza dei dati verrà 
adesso gestita tramite questo DB. 
Symbian OS, attualmente, vede 
un grande contributo di Nokia, so- 



cietà che ne detiene quasi il 48%. 
Allo stesso tempo il sistema ope- 
rativo di Symbian detiene quasi 
il 65% del mercato, nonostante 
che Windows Mobile 5.0 conti- 
nui a guadagnare posizioni. La 
data di rilascio prevista: il 2009, fa 
presupporre che una diminu- 
zione delle richieste hardware, 
pur sempre gradita, non rap- 
presenti una novità di così enor- 
me rilievo. Di fatto due anni di 
evoluzione informatica rappre- 
sentano un periodo sufficiente- 
mente lungo per poter garantire 
che a quella data l'hardware dei 
dispositivi mobili sarà probabil- 
mente ulteriormente potenzia- 
to. Interessante invece proprio 
in un' ottica futura il miglior sup- 
porto al Voice Over Ip e alla TV 
via rete 
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j2ME e la comunicazione in rete 



AGGIORNA IL BLOG 
CON IL CELLULARE 

IN QUESTO ARTICOLO VEDREMO COME SVILUPPARE UN'APPLICAZIONE CLIENT IN J2ME CHE 
SI CONNETTE AD UN SERVER IN PHP E CONSENTE DI INSERIRE DINAMICAMENTE CONTENUTI 
SUL WEB TRAMITE IL TELEFONINO 
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MobileBlog.zip 
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REQUISITI 



Conoscenze richieste 



— Medie di Java ME. Base 
Là di PHP e MySQL 



f 



Sun Java Wireless 
Toolkit, PHP, Web 
Server, MySQL 



0000 



Utilizzando Java ME (Micro Edition), PHP e 
MySQL si possono sviluppare applicazioni 
client/ server molto interessanti. In questo 
articolo vedremo come far interagire le tre tecnolo- 
gie sviluppando una semplice e utile applicazione che 
ci permetterà di interagire con un blog multiutente. 
Il motto di Java è " Write once, run anywhere", os- 
sia basta scrivere l'applicazione una sola volta 
e questa girerà su qualunque sistema. A quan- 
to pare tale motto continua a valere anche per 
i dispositivi mobili. Infatti, Java ME, sin da quan- 
do è nato, ha avuto un grosso impatto nel mon- 
do dello sviluppo orientato a cellulari e pal- 
mari. Anche se alcuni possono obiettare che 
Java ME non è tanto portabile quanto altre tec- 
nologie Java, il risultato ottenuto sulla maggior 
parte dei dispositivi è, il più delle volte, am- 
piamente accettabile. Nel pensare un'applica- 
zione client/server, dove il client è sviluppato uti- 
lizzando Java ME, la scelta più ovvia per la par- 
te server, o meglio la prima che viene in men- 
te, ricade su Java Enterprise Edition (EE). Ov- 
viamente quando si ha a disposizione un web ser- 
ver che supporta tale tecnologia allora Java EE 
può rappresentare la scelta migliore. E' noto, 
tuttavia, che i domini che supportano JSP e 
Servlet non sono dei più economici! D'altro 
canto, acquistare un dominio che fornisce il 
supporto per PHP può risultare una scelta van- 
taggiosissima per le nostre tasche. Per tale mo- 
tivo la parte server dell'applicazione oggetto 
dell'articolo è stata sviluppata in PHP. Ad ogni 
modo, se avete a disposizione un web server 
con supporto per Java EE, convertire gli script 
PHP in Servlet e/o JSP non sarà una cosa com- 
plicata. Manca ancora un tassello per comple- 
tare il quadro. A parte la comunicazione client/ser- 
ver abbiamo bisogno di uno strumento per me- 
morizzare, in modo permanente, le informa- 
zioni relative al blog. A tal proposito utilizzere- 
mo un DB ed in particolare MySQL. In figura 1 
è mostrata l'interazione completa tra client (Ja- 
va ME), server (PHP) e DB (MySQL). 



CLIENT 




SERVER 













DB 



Fig. 1: Comunicazione tra client, server e DB. 



In figura 2, invece, potete vedere lo schema della 
semplice base dati utilizzata per quest'articolo. A pro- 
posito, nel codice che trovate nel CD allegato vi è uno 
script che potete usare per la creazione del DB in que- 
stione. Vi basterà creare un DB di nome blog e poi lan- 
ciare lo script per la creazione delle tabelle. 



BlflaiBE VAECHARI20J |FK} 
pxu-mm il: VARCHARUO} 



JL 



Pwtl 



villini: VARCHAltlll» |FK) 

IHttliiigDifte: DATETI ME 

Bile: VARCHAR(fW 



Fig. 2: Il semplice database atto a memorizzare 
i post e gli utenti 



LA MOSTRA 
APPLICAZIONE 

Vediamo ora in cosa consiste la nostra applicazione. 
Ciò che vogliamo realizzare è un software che ci per- 
metta di gestire un blog multiutente. Per blog mul- 
tiutente s'intende, in parole povere, un blog che può 
essere aggiornato da più persone, basta che queste 
abbiano un account che gli permetta di accedere, in 
update, al blog in questione. Come avrete intuito dal- 
la figura 2, gli utenti con questi "poteri" di aggiornamento 
sono memorizzati nella tabella Users. Dato che user- 
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name deve essere univoco lo abbiamo scelto anche 
come chiave primaria della tabella. Ciò che l'utente 
inserisce nel blog è chiamato post. Un singolo post è 
formato da: 

• id: la chiave primaria 

• author: username dell'autore e che costituisce la 
chiave esterna 

• posting_date: la data e l'ora di inserimento del 
post 

• title: il titolo del post 

• text: il testo del post 

Chiaramente avremmo potuto complicare il nostro 
DB utilizzando altre tabelle per gestire ulteriori infor- 
mazioni, però ciò che abbiamo visto è sufficiente per 
gestire un blog di base. 

Andiamo, ora, ad analizzare la nostra applicazione 
dividendola logicamente nelle sue due parti archi- 
tetturali, ossia il client ed server. 



PARTE CLIENT 

Come abbiamo già accennato, la parte client dell'ap- 
plicazione sarà sviluppata in Java ME. Questo ci con- 
sentirà un suo deploy su qualsiasi dispositivo mobi- 
le Java ME-compliant. Abbiamo visto che, per poter in- 
serire un post, l'utente deve avere un account valido 
censito all'interno della tabella Users. Tale account 
sarà "mappato" localmente sul cellulare. Per tale mo- 
tivo, al primo avvio dell'applicazione, viene chiesto 
username e password all'utente. Le credenziali del- 
l'utente saranno memorizzate sul cellulare utilizzan- 
do RMS in modo da non doverle richiedere ogni qual 
volta l'applicazione viene avviata. Ecco il codice ese- 
guito ad ogni avvio: 

protected void startApp() 

{ 

// Se è il primo accesso rimanda alla form 

di login 
if (isLoginEmptyO) 

{ 

setDisplay(fmLogin); 

} 
else 

{ 

setDisplay(lsMain); 



[■■■] 

private boolean isLoginEmptyO 

J 

RecordManager rm = new 

RecordManager(Constants.RMS_LOGIN); 
return (rm.numRecords() < 2); 
} 



La prima cosa che fa è controllare se vi è un login già 
precedentemente effettuato. In tal caso visualizza il 
menu principale altrimenti forza un login e, in segui- 
to, visualizza il menu visibile in figura 3. 




Fig. 3: Menu principale dell'applicazione 



RecordManager è una classe di utilità che ho scritto per 
semplificare le operazioni di scrittura, modifica, lettura 
ed eliminazione di record dal record store. Record- 
Manager incapsula alcune API di RMS in modo da 
"simulare" una memorizzazione diretta di stringhe e 
non di array di byte, il che è molto più comodo per i no- 
stri scopi. Nel record store riguardante login, user- 
name è memorizzato nel primo record mentre la pas- 
sword nel secondo. Se il numero di record è inferiore 
a due significa che il record store creato è vuoto e quin- 
di non vi sono ancora le credenziali dell'utente. 
Le voci del menu principale sono: 

• Scrivi Post 

• UploadPost 

• Download Post 

• Logout 

In particolare Logout elimina le credenziali dal re- 




RISORSE UTILI 

Sun Java Wireless 
Toolkit for CLDC: 

http://java.sun.com/ 

products/sìwtoolkit/ 

PHP: 

http://www.php.net 

MySQL: 

http://www. mvsq I .com 

Apache HTTP Server: 

http://httpd.apache.orq/ 
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IDE PER 

JAVA ME 

Per sviluppare applica- 
zioni con Java Micro 
Edition potete tran- 
quillamente utilizzare 
il Wireless Toolkit 
della Sun. Se, tuttavia, 
siete degli appassiona- 
ti di Eclipse potreste 
voler provare un plug- 
in apposito, ossia 
EclipseME che trovate 
al seguente indirizzo: 
http://ecl ipseme.org/ 
lo lo uso regolarmente 
e lo trovo abbastanza 
buono. 



cord store e richiede le nuove. Questo permetterà al- 
l'utente un'eventuale modifica dei propri dati oppu- 
re l'utilizzo dell'applicazione da parte di qualche altro 
utente. 



SCRITTURA DI UHI POST 

Selezionando Scrivi Post dal menu principale l'uten- 
te vedrà un form simile a quello di figura 4. 




Fig. 4: Form che consente la scrittura di un nuovo post 

Inserendo titolo e testo e scegliendo Memorizza dal- 
la lista dei comandi [Meri u) , il post viene aggiunto al- 
la lista locale. Abbiamo scelto di memorizzare i post lo- 
calmente ed effettuarne l'upload in un colpo solo per 
ottimizzare gli accessi alla rete. Selezionando, poi, 
Upload Post dal menu principale, tutti i post pre- 
senti nel record store saranno trasferiti al server. 
Per creare un form abbiamo esteso la classe Form ed 
implementato l'interfaccia CommandListener, en- 
trambe del package javax.microedition.lcdui. In par- 
ticolare l'implementazione del metodo comman- 
dAction di CommandListener ci permette di gestire 



i comandi selezionati dall'utente. Ecco l'inizio della 
classe FormWritePost: 

public class FormWritePost extends Form implements 

CommandListener 

{ 

// midlet 

private MidletBlog midlet; 



// display precendente 



private Displayable previousDisplay; 



// item 



private TextField tfTitle; 



private TextField tfText; 



// comandi 



private static final Command cmExit = 

CommandBuilder.getExitO; 
private static final Command cmStore = 

Command Builder.getStoreQ; 
private static final Command cmBack = 

Command Builder.getBack(); 



[■■■] 



Come si può vedere, vi è un riferimento alla midlet ed 
uno al display precedente. In particolare, quest'ultimo 
lo utilizziamo quando viene scelto il comando Indie- 
tro. In seguito, vi sono due textbox atti a ricevere tito- 
lo e testo del post. Il codice restante concerne i tre co- 
mandi riguardanti il form, ossia: Esci, Memorizza 
ed Indietro. Il primo termina l'applicazione. Il se- 
condo memorizza il post usando RMS. Il terzo torna 
al menu principale. I vari comandi utilizzati in tutta l'ap- 
plicazione sono creati attraverso la classe Com- 
mandBuilder che è una sorta di "command provider". 
Quello che segue è, invece il codice concernente il co- 
struttore della classe in questione: 

public FormWritePost(MidletBlog midlet, Displayable 

previousDisplay) 

{ 

super("Scrivi Post"); 
this. midlet = midlet; 
this. previousDisplay = previousDisplay; 

tfTitle = new TextField("Titolo", "", 50, 

TextField.ANY); 

tfText = new TextField("Testo", "", 500, 

TextField.ANY); 

// Aggiunge gli item al form 

append(tfTitle); 

append(tfText); 

// Aggiunge i comandi 

addCommand(cmExit); 

addCommand(cmStore); 

addCommand(cmBack); 



// Imposta il listener 
setCommandListener(this); 
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Esso invoca il costruttore di Form passando il titolo 
da visualizzare. In seguito valorizza midlet e previou- 
sDisplay, istanzia i textbox e li aggiunge, assieme ai 
comandi, al form vero e proprio. L'ultima riga di codice 
serve ad impostare il listener dei comandi per il form 
appena creato. Quando l'utente sceglie un comando 
viene invocato il metodo commandAction che è l'u- 
nico dichiarato nell'interfaccia CommandListener e 
che dobbiamo implementare per rispettarne il contratto. 
Eccone il codice: 

public void commandAction 

(Command e, Displayable d) 



{ 


if (e 


= = cmExit) 




{ 


midlet. shutDownApp(false); 


} 


else 


if (e == cmBack) 




{ 


midlet. setDisplay(previousDisplay); 


} 


else 


if (e == cmStore) 




{ 


// titolo 


String title = tfTitle.getString(); 


// testo 


String text = tfText.getString(); 


String post = title + 

Constants.SEPARATOR + text; 


// Memorizza il record 


RecordManager rm = new 
RecordManager(Constants.RMS_POSTS); 


if (rm.addRecord(post)) 


{ 




midlet. showInfo( 
memorizzato correttamente" 


Post 
, this); 




tfTitle.setString(" 


'); 




tfText.setString(" 


'); 


} 


else 


{ 


midlet. showInfo( 


"Post non memorizzato correttamente, riprova 

tardi" 


più 
, this); 


} 


} 



} 



Il metodo commandAction prende due parametri. Il 
primo è un riferimento al comando scelto dall'uten- 
te. Il secondo indica su quale oggetto Displayable è 
stato selezionato il comando. Nel nostro caso esso è il 
form vero e proprio. La parte di codice più interes- 
sante è quella riguardante la selezione del comando 
cmStore, ossia quello concernente la memorizzazio- 
ne del post. Il blocco di codice relativo, recupera tito- 
lo e testo dalle textbox e costruisce la stringa che rap- 



presenta un post. SEPARATOR è la stringa da utiliz- 
zare per separare logicamente titolo e testo del post. 
Nel nostro caso abbiamo usato il carattere | (pipe). 
Ovviamente potete cambiarlo a seconda le vostre ne- 
cessità. SEPARATOR, assieme ad altre costanti, è me- 
morizzato nella classe Constants. 
Il codice continua con la memorizzazione del post 
attraverso RMS. Come potete notare, anche in que- 
sto caso ci torna utile la classe RecordManager. In so- 
stanza viene memorizzato il post e svuotati i campi 
titolo e testo per consentire l'aggiunta di ulteriori po- 
st. Se tutto va a buon fine viene notificato il successo 
altrimenti un fallimento. Tutto ciò servirebbe a ben 
poco se non ci fosse una funzionalità che permette 
di inviare i post al cellulare. 



UPLOAD DEI POST 

Quando, dal menu principale, viene selezionato Upload 
Post la midlet esegue il seguente codice: 




// Recupera i post usando RMS 



RecordManager rm = new 

RecordManager(Constants.RMS_POSTS); 
String[] posts = rm.getAIIRecords(); 



// Invia i post 



PostSender ps = new PostSender(this, IsMain, new 

Login().getUser(), posts); 
ps.send(); 

Tale codice recupera, come array di stringhe, tutti i 
post precedentemente memorizzati. In seguito, at- 
traverso la classe PostSender, li invia al server. Il co- 
struttore di tale classe è il seguente: 



pu 


blic 


PostSe 


nder(MidletBlog 


midlet, Displayable 

previousDisplay, 








User user, 


String[] posts) 


{ 






this 


midlet = midlet; 








this 


previousDisplay 


= previousDisplay; 






this 


user = user; 








this 


posts = posts; 




} 



Esso prende in ingresso quattro parametri, che sono: 
il riferimento alla midlet, riferimento al display pre- 
cedente, un riferimento di tipo User ed un array di 
stringhe che rappresentano, appunto, i post da in- 
viare. Tra i campi privati della classe vi è anche l'URL 
da utilizzare: 

private static final String URL = 
"http://localhost/MobìleBlogServer/post_sender.php"; 

Esso fa riferimento allo script post_sender.php che, 
come vedremo quando analizzeremo la parte server, 
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EASYPHP 

Se non siete pratici 
dell'installazione 
di PHP, Web server 
e MySQL allora potete 
utilizzare EasyPHP. 
Installando quest'ulti- 
mo otterrete, in un 
colpo solo, Apache 
Web Server, MySQL, 
PHP e PHPMyAdmin. 
Quest'ultimo, in parti- 
colare, vi permetterà 
di creare il DB molto 
agevolmente attraver- 
so una comoda inter- 
faccia. L'indirizzo 
di riferimento 
è il seguente: 
http://www.easyphp. 
org/?lang=it 



si occupa della persistenza dei post. Il metodo send 
della classe PostSender invia, in un thread separato, i 
post al server. L'avvio di tale thread invoca il metodo 
responsabile dell'invio vero e proprio. Tale metodo è 
sendPost: 

private void sendPost() throws IOException 

{ 

String agent = "Mozilla/4.0"; 

String type = "application/x-www-form- 

urlencoded"; 
// Costruisce il corpo della richiesta da 

inviare, 



// ossia il payload 



String qs = buildRequestBody(); 



InputStream is = nuli 



HttpConnection http = nuli 



DataOutputStream dos = nuli 



StringBuffer sb = new StringBuffer(); 



try 



{ 



// Stabilisce la connessione 



http = (HttpConnection) 
Connector.open(URL, Connector.READ_WRITE); 



// Imposta il metodo come POST 



http. setRequestMethod(HttpConnection. POST); 



// Imposta gli altri header 



http.setRequestProperty 

("User-Agent", agent); 



http.setRequestProperty("Content-Type", type); 
http.setRequestProperty("Content-Length", "" + 

qs.length()); 



// Invia il payload 



dos 



http. open DataOutputStream(); 



byte[] byteRequest 



qs.getBytes(); 



for (int i = 0; i < 

byteRequest. length; i ++) 



{ 



dos.writeByte(byteRequest[i]); 



} 



// Riceve il response 



is = new 
DataInputStream(http.openInputStream()); 



int eh; 



while ((eh = is.read()) != -1) 



{ 



sb.append((char) eh); 



} 



catch (Exception e) 



{ 



System. err.println("Error: " + 



e.toStringO); 



networkError(e.toString()); 



[■■■] 



} 



La parte più interessante di questo codice è l'invio 
delle informazioni al server tramite il metodo HTTP PO- 
ST. Non sarebbe stato praticabile inviare i dati trami- 
te GET dato che i post possono avere una dimensio- 
ne notevole. Come si può notare, quel codice, dopo 
aver aperto la connessione, imposta il metodo a PO- 
ST ed i vari header necessari per utilizzare tale meto- 
do. In seguito invia il payload, ossia le informazioni 
necessarie, utilizzando un DataOutputStream. Il pay- 
load lo abbiamo ottenuto grazie alla chiamata al me- 
todo buildRequestBody: 

String qs = buildRequestBody 0; 

Il codice di tale metodo è il seguente: 

private String buildRequestBody() 

1 

StringBuffer ret = new StringBuffer(); 
// username 
ret.append("username=" + 

Utils.encodeURL(user.getUsername())); 
// password 
ret.append("&password = " + 

Utils.encodeURL(user.getPassword())); 
// separatore 
ret.append("&separator=" + 

Utils.encodeURL(Constants.SEPARATOR)); 
// messaggio di successo 
ret.append("&success=" + 
Utils.encodeURL(Constants.SUCCESS_RESPONSE)); 
// Aggiunge i post nel formato: 
post[] =titolol | testol&post[] =titolo2 1 testo2. . . 
for(int i = 0; i < posts. length; i++) 

{ 

ret.append("&post[] = " + 

Utils.encodeURL(posts[i])); 

} 

return ret.toString(); 

} 



In pratica viene creata una stringa che ha il formato di 
una query string, ossia: 

keyl=valuel&key2=value2... 

Tale stringa contiene username, password, caratte- 
re usato per separare titolo e testo del post, il mes- 
saggio di successo ed i post veri e propri. Abbiamo 
scelto di inviare carattere separatore al server di mo- 
do che, se dovessimo decidere di cambiare questo ca- 
rattere in futuro, il lato server continuerebbe a fun- 
zionare senza problemi. Per quanto riguarda il mes- 
saggio di successo, la necessità di gestirlo lato client sta 
nel fatto che, se l'upload va a buon fine, dobbiamo 
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svuotare il record store locale dove risiedono i post. 
Capiamo che l'upload è andato a buon fine nel momento 
in cui il server ci torna indietro il messaggio di suc- 
cesso da noi inviato. 

Da notare, inoltre, che i vari post sono inviati utiliz- 
zando la seguente sintassi: 

post[] = postl&post[] = post2... 

Questo ci consentirà di ricevere lato server, come ve- 
dremo, i vari post in un unico array. Il resto del codi- 
ce non richiede particolari spiegazioni. Dopo l'invio 
del post si attende il response del server e viene mo- 
strato un alert sia in caso di successo sia di fallimen- 
to. Vi è da sottolineare che in caso di successo il re- 
cord store rappresentante i post viene svuotato. 



DOWNLOAD DEL POST 

Selezionando Download Post dal menu principale 
si avvia il thread responsabile del download dell'ulti- 
mo post dal server. Il codice responsabile di ciò è il 
seguente: 

PostRetriever pr = new PostRetriever(this, IsMain); 
pr.retrieve(); 

La classe PostRetriever, dal punto di vista "didattico", 
è simile alla precedente. L'unica differenza sostan- 
ziale è che la richiesta viene effettuata utilizzando GET 
invece di POST. Inoltre, l'URL utilizzato è il seguente: 

private static final String URL = 

"http://localhost/MobileBlogServer/posL 
retriever.php"; 

Il metodo che, internamente, viene invocato dal thread 
è getPost. Eccone il codice: 

private void getPost() throws IOException 

{ 

InputStream is = nuli; 
StringBuffer sb = nuli; 
HttpConnection http = nuli; 
try 

{ 

String completeURL = URL + 

"?separator=" + 
Utils.encodeURL(Constants.SEPARATOR); 
// Stabilisci la connessione 
http = (HttpConnection) 

Connector.open(completeURL); 



// Imposta GET come metodo 



HTTP 



HttpConnection. HTTP_OK){ 


sb = new 

StringBuffer(); 


int eh; 


is = 
http.openInputStream(); 


while ((eh = is.read()) 
!= -1) 


sb.append((char) 


eh); 




} 


else 


{ 


System. out.printl 


"i("Network error"); 


networkError(); 


} 


} 


catch (Exception e) 


{ 




System 


err.println("Error: " + 

e.toStringO); 


networkError(e.toString()); 


} 


finally 


{ 


[■■■] 


} 


if (post 


= nuli) 




{ 




System 


out.println(post); 




midlet.s 


howPosts(post, 

getCurrentDisplayO); 


} 


else 


{ 


networkError(); 


} 


} 



Come si può vedere l'utilizzo di GET è molto più sem- 
plice rispetto a POST. In tal caso l'impiego di tale me- 
todo è più che giustificato dato che l'URL della ri- 
chiesta comprensivo di query string ha dimensioni 
ragionevoli per una richiesta di tipo GET. Se tutto è 
andato a buon fine il post scaricato viene visualizza- 
to tramite il metodo showPosts della classe Midlet- 
Blog, ossia l'unica midlet dell'applicazione. Il codice 
di showPosts è seguente: 

public void showPosts(String rawPost, Displayable d) 



{ 



PostParser pp = new PostParser(rawPost); 



try 



// Estrae il post dalla stringa in 

formato "grezzo" 




COSA VUOL 

DIRE RMS? 

RMS sta per Record 
Management System. 
Esso è il sistema utiliz- 
zato da Java ME per la 
persistenza di infor- 
mazioni. Viste le 
capacità hardware 
ridotte dei cellulari 
non ci si poteva 
aspettare di trovare 
Oracle o qualsiasi altro 
DB installato su di 
esso! In Java ME le 
informazioni sono, 
quindi, memorizzate 
all'interno di Record 
Store. Un record store 
è formato da un 
insieme di record dove 
ogni record è visto 
come un array di byte. 
Ogni MIDIet può 
gestire più record 
store. La nostra appli- 
cazione ne gestisce 
due. Uno relativo alla 
memorizzazione delle 
credenziali e l'altro 
concernente la persis- 
tenza temporanea dei 
post. 



http. setRequestMethod( HttpConnection. GET); 



Post post = pp.parse(); 



// Gestisci il response 



// Lo visualizza 



if (http.getResponseCode() 



FormDisplayPost fdp = new 
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FormDisplayPost(this, d, post); 



setDisplay(fdp); 



} 



catch (IllegalArgumentException iae) 



{ 



[■■■] 



} 



Il post scaricato è in una forma "grezza", ossia è for- 
mato da titolo e testo separati dal carattere separato- 
re che abbiamo già visto. Per tale motivo viene utiliz- 
zato PostParser per eseguire parsing del post. Il me- 
todo parse spezza la stringa che rappresenta il post 
nelle varie parti e restituisce un oggetto di tipo Post 
costruito tramite questi token. La visualizzazione ve- 
ra e propria del post avviene tramite il form FormDi- 
splayPost che non vedremo per brevità. 



PARTE SERVER 

La parte server, oltre al database, è costituita da tre fi- 
le PHP: config.inc.php, post_sender.php e po- 
st _retriever.php. Il primo è un file incluso dagli al- 
tri due; esso contiene le configurazioni riguardanti il 
DB, la funzione connect che effettua la connessione 
vera e propria ed una funzione di utilità che control- 
la l'invio dei parametri obbligatori. 
L'invio dei post avviene attraverso post_sender.php. 
Ecco l'inizio dello script: 

<?php 



header("Content-type: text/plain"); 



require("config.inc.php"); 



$required_parameters = array("username", 

"password", "separator", "success", "post"); 
check_parameters($required_parameters); 

// recupera i dati inviati dal client 
$username = 

trim($_REQUEST[$required_parameters[0]]); 
$password = 

trim($_REQUEST[$required_parameters[l]]); 
$separator = 

trim($_REQUEST[$required_parameters[2]]); 
$success = 

trim($_REQUEST[$required_parameters[3]]); 

$posts = $_REQUEST[$required_parameters[4]]; 
[■■■] 

Come si può vedere, tale script imposta il content ty- 
pe del response a text/plain dato che esso sarà una 
mera notifica di successo o fallimento della scrittura 
dei post nel DB. Il file conflg. ine. php contiene, come 



abbiamo detto, le funzioni check_parameters e con- 
nect, utilizzate per controllare l'invio dei parametri e 
connettersi al DB, rispettivamente. I parametri che lo 
script si aspetta sono: username dell'utente, la sua 
password, il carattere utilizzato come separatore di 
titolo e testo dei post, il messaggio di successo ed i po- 
st veri e propri inviati come array di stringhe. Il codi- 
ce continua come segue: 

// connessione al DB 

$db = connectQ; 

// imposta la query da usare per controllare le 

credenziali 
$query = "SELECT username, password FROM users 
WHERE username='$username' AND 
password = '$password'"; 



// la esegue 



$result = mysql_query($query, $db); 



if(mysql_nunwows($result) 



0) 



{ 



mysql_close($db); 



// credenziali non valide 



echo "Username e/o password non validi" 



die(); 



} 



Questo pezzo di codice effettua la connessione al DB 
e controlla che le credenziali inviate dall'utente sia- 
no valide. In caso negativo chiude la connessione col 
DB, restituisce al client (al cellulare) una notifica ed 
interrompe lo script. Se le credenziali, invece, sono 
valide il codice eseguito è il seguente: 

else // credenziali valide 

1 

$error = false; 

// inserisce nel DB tutti i post ricevuti 
foreach($posts as $post) 

{ 

$pieces = explode($separator, 

$post); 
$title = addslashes($pieces[0]); 
$text = addslashes($pieces[l]); 
// data odierna 
$date = date("Y-m-d H:i:s"); 
// imposta la query 
$query = "INSERT INTO 
posts(author, posting_date, title, text) 
VALUES('$username', '$date', '$title', '$text')"; 
// la esegue 
$result = mysqLquery($query, 

$db); 



if(!$result) 

jt 

$error = true; 



». 22 /Maggio 2007 



http://www.ioprogrammo.it 



016-023 Mobile 28-03-2007 14:42 Pagina 23 



J2ME e la comunicazione in rete H T COVER STORY 



break; 


} 


} 


if($error) 


{ 


echio "Non tutti i post sono stati 
inseriti correttamente. Riprova più tardi"; 


} 


else 


{ 


echo $success; 


} 


} 


mysql_close($db); 


?> 



Il codice precedente non fa altro che ciclare sui post 
ricevuti ed inserirli, uno ad uno, nel DB. Se si verifica 
un errore durante tale operazione il ciclo si intenompe 
ed il client viene notificato del fallimento. Se tutto va 
a buon fine, invece, al client viene inviato il messaggio 
di successo che esso stesso ci ha richiesto di restitui- 
re in caso di successo. Infine viene rilasciata la con- 
nessione precedentemente acquisita. 
L'operazione complementare consiste nello scarica- 
re, sul cellulare, l'ultimo post inserito. Quest'opera- 
zione potrebbe sembrare senza senso nel caso in cui 
il blog sia monoutente. Dato che, tuttavia, il blog è 
multiutente potrebbe aver senso sapere chi è stato 
l'ultimo a postare qualcosa e conoscere il contenuto 
del post. Lo script lato server atto a recuperare l'ulti- 
mo post è post_retriever.php. Il suo codice è il se- 
guente: 

<?php 

require("config.inc.php"); 
$required_parameters = array("separator"); 
check_parameters($required_parameters); 
$separator = 

trim($_REQUEST[$required_parameters[0]]); 
// connessione al DB 
$db = connect(); 

// imposta la query da usare per recuperare l'ultimo 

post 

$query = "SELECT author, posting_date, title, text 

FROM posts ORDER BY id DESC LIMIT 0,1"; 



//execute it 



$result = mysql_query($query, $db); 
if(mysql_num_rows($result) == 0) 



{ 



echo "Nessun post presente" 



die(); 



else 



$rawPost 



$text) = mysql_fetch_array($result)) 

$text = stripslashes($text); 
// mette il post nel formato 

autore | data | titolo | testo 



$rawPost .= $author . 



$separator 



$posting_date . $separator 



$title . $separator 



$text; 



} 



echo $rawPost; 



} 



mysq l_close($d b) ; 



while(list($author, $posting_date, $title. 



?> 



In questo caso l'unico parametro richiesto è il carat- 
tere utilizzato come separatore. Questo perché il client, 
come già visto, si aspetta il post nel formato: auto- 
re|data|titolo|testo, supposto che il separatore usato 
sia il carattere pipe (|) . Questo carattere, come già det- 
to, può essere modificato a piacimento ed è "coman- 
dato" dal client. In pratica stiamo dicendo al server: "Re- 
cuperami l'ultimo post e mettimi i vari campi in una 
stringa unica separandoli tramite il carattere separa- 
tore che ti ho inviato nella richiesta". Lo script quin- 
di esegue la query, mette il risultato nel formato desi- 
derato e lo restituisce al client. Da notare la query uti- 
lizzata per ottenere l'ultimo post: 

SELECT author, posting_date, title, text FROM posts 
ORDER BY id DESC LIMIT 0,1 

In pratica, ordinando per id in modo decrescente ed 
utilizzando la clausola LIMIT 0,1 otteniamo l'ultimo 
post in ordine di inserimento, che è proprio quello 
che volevamo. 



CONCLUSIONI 

In quest'articolo abbiamo visto come sviluppare una 
completa applicazione client/ server dove il client è 
costituito da un comune cellulare che supporta Java 
ME ed il server da un classico web server con sup- 
porto per PHE In più abbiamo fatto uso di un DB, nel 
nostro caso MySQL ma potete usare quello a voi più 
consono. Ovviamente l'applicazione è ampiamente co- 
stumizzabile ed ampliabile a piacimento. Ad esem- 
pio, potreste voler scaricare più post invece che uno so- 
lo e visualizzare tale lista. Un'altra miglioria sarebbe ge- 
stire l'inserimento dei post con una transazione di 
modo che vengano inseriti o tutti o nessuno. Chiara- 
mente lo sviluppo di queste funzionalità è lasciato co- 
me esercizio al lettore. 

Alessandro Lacava 
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SVILUPPARE GADGET 
PER WINDOWS VISTA 

IN QUESTO ARTICOLO IMPAREREMO AD USARE UNA DELLE TECNOLOGIE PIÙ DIVERTENTI 
LEGATE ALLA NUOVA VERSIONE DI WINDOWS. PARLEREMO DELLA SIDEBAR E SVILUPPEREMO 
UNA "MINIAPPLICAZIONE" CHE MONITORA LO SPAZIO DISPONIBILE SULL'HARD DISK 




Ok, cosa è un gadget per Windows Vista? 
Togliamoci subito il pensiero e dicia- 
mo che si tratta di una miniapplicazio- 
ne visibile nella sidebar. D'accordo non avete 
installato Windows Vista, per cui il termine Si- 
deBar non vi dice assolutamente niente di nuo- 
vo. Sostanzialmente la SideBar di Windows Vi- 
sta si può considerare come una sorta di con- 
tenitore adagiato sul Desktop. Tipicamente al- 
l'interno di questo contenitore vivono delle mi- 
niapplicazioni: i gadget. Nell'immagine di se- 




Figura 1: II desktop di vista. Sul lato destro e ben visibile la sidebar 




REQUISITI 



Conoscenze richieste 



G Java 



i JDK 1.4 o superiori 



È 




guito potete vedere appunto un desktop di Win- 
dows Vista, corredato di SideBar all'interno del- 
la quale ci sono tre gadget. Il primo mostra co- 
stantemente l'ultima copertina di una delle ri- 
viste prodotte dalla Edizioni Master: Win Ma- 
gazine, il secondo mostra un orologio con l'o- 
ra corrente, il terzo mostra uno slideshow di im- 
magini random prelevate dalla rete. 
Inutile dire che il Gadget che mostra l'ultima 
copertina di Win Magazine è stato creato dai ra- 
gazzi di ioProgrammo, mentre gli altri due si 
trovano già inclusi nell'installazione di default 



di Windows Vista. In questo articolo imparere- 
mo appunto a sviluppare un gadget per Win- 
dows Vista. 



DUE PAROLE SUI 
GADGET 

Prima di cominciare sarà bene fare un po' di 
esperienza sugli oggetti che andremo ad utiliz- 
zare. Il sito http://microsoftqadqets.com/Gallerv/ 
contiene una lista lunghissima di gadget da po- 
ter prelevare gratuitamente ed installare sul vo- 
stro computer. L'installazione è davvero bana- 
le, è sufficiente scovare sul web il gadget che vi 
interessa, cliccare, ed il gioco è fatto! Ve lo ri- 
trovate per magia nella sidebar. Questo non è 
ovviamente l'unico modo per installare un Gad- 
get. Qualcuno può mandarvene uno via email ad 
esempio, ciò che conta è che se trovate un file con 
estensione .gadgets sarà sufficiente cliccarci sopra 
due volte per ritrovarvelo, bello come il sole, nella 
vostra sidebar. Se avrete la pazienza di provare 
qualche Gadget fra quelli esistenti, scoprirete che 
le possibilità di interazione sono tante, di fatto è 
possibile usare form, input immesso dall'utente, 
database, fetch di informazioni dal Web e così via. 
Inutile dire che sui gadget si sta sviluppando un 
mercato enorme e che tutti i più grossi produttori 
di software stanno cominciando a sviluppare le 
proprie applicazioni agganciandovi spesso un gad- 
get, motivo per cui noi programmatori non pos- 
siamo non imparare a programmarne uno. 



DENTRO LA 
TECNOLOGIA 

Al solito, il miglior modo per imparare una nuo- 
va tecnica è metterci le mani dentro. È esattamente 
quello che faremo in questo paragrafo. 

1) Abilitate la sidebar: potete farlo dal menu ac- 
cessori di Windows Vista cliccando su "Win- 



-XT 

I 
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dows Sidebar" zionati tutti i gadget relativi all'utente che sta- 

te utilizzando 
2) Avviate un prompt di Windows e al suo interno 
digitate "%userprofile%\AppData\Local\Mi- 4)Create qui dentro una cartella chiamata ciao- 
crosoft\ Windows Sidebar\Gadgets" mondo. gadget 

3)Si aprirà una cartella, qui dentro vanno posi- L'infrastruttura per il nostro primo gadget è 

IL NOSTRO PRIMO GADGET IN TRE PASSI 

UNA V OLTA CREATA LA STRUTTURA DI BASE, TUTTO VIENE DELEGATO ALLA NOSTRA FANTASIA 

> IL GIUSTO PERCORSO > I NOMI DELLE CARTELLE > LA DISTRIBUZIONE 




jJ" Cerca ovunque 
y) Cerca in Internet 



%userp rof i I e%\ Ap p data\L o ca l\M i t ro soft 




JraLid^ghA. *-?M-*ju*. 



DApri il prompt dei comandi e portati 
nella directory dell'utente che con- 
terrà il gadget 





«m 


Uwn.m^. 








| Min* 

UH 

i WHhMKhl 

. ™_ ri 

lliiiriiiW|ii^B 






bMk4n 

^i. ■»■■ lUMMlìlI 



Crea qui dentro una cartella nome.gad- 
gets, e metti qui dentro il file mani- 
fest e gli altri 




Zippa la cartella e rinomina l'esten- 
sione da .zip a .gadgets, e sei pronto 
per distribuire 



AL SICURO. 
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tihl 




Figura 4: il gadget non 
appare centrato 



pronta. Da questi primi 4 passi devono risulta- 
re chiare solo un paio di cose: tutti i gadget re- 
lativi ad un certo utente vanno nella cartella a cui 
ci si riferisce con il passo 2. 1 file necessari alla 
costruzione del gadget vanno in una sottocar- 
tella di quella precedente nominata con il nome 
del gadget e con l'estensione .gadget 



QUALCHE FILE 

È il momento di costruire fisicamente il nostro 
gadget. D'accordo, potete meravigliarvi quan- 
to vi pare, ma diciamo subito che non c'è ne- 
cessità di creare un'eseguibile né di avventu- 
rarsi all'interno di complicatissime chiamate 
di sistema. Un gadget è costituito da una serie 
di file HTML, qualche XML, CSS se vi servono 
e, se proprio volete divertirvi, un po' di Java- 
Script. Abbastanza stupiti? Non ancora? Ok ve- 
diamo cosa dobbiamo mettere nella nostra car- 
tella ciaomondo. Gadget. 

1) Un file XML che descriverà il gadget. Questo 
file viene chiamato anche manifest del gad- 
get. Al suo interno verranno definite cose co- 
me il nome del gadget, l'icona con cui deve 
apparire nel pannello di controllo, un'even- 
tuale descrizione 

2) Un file HTML che conterrà la logica del gad- 
get. Ovvero la sua interfaccia grafica, gli script 
Javascript e tutto quello che serve per "far vi- 
vere" il nostro gadget. Ovviamente se siete dei 
programmatori provetti creerete una direc- 
tory per contenere i CSS, una per i Javascript 
etc, ed includerete tutto nel file HTML che in- 
vece definirà solo l'interfaccia 

3) Immagini, script, file CSS che possono ser- 
vire al gadget 

4) Un'icona che rappresenterà il gadget nel pan- 
nello di controllo. 



outhor name="Fabio Farnesi"> 



<info url = "forum. ioprogrammo.it" /> 



</author> 



< copy right> 2007 </copyright> 



<description>ioProgrammo - Developer Italian 

Style</description> 



<hosts> 



<host name="sidebar"> 



<base type="HTML" apiVersion = "1.0.0" 

src="ciaomondo.htm[" /> 
<permissions>full</permissions> 
<platform minPlatformVersion = "0.3" /> 
</host> 



</hosts> 



</gadget> 

Non entriamo attualmente nel dettaglio del sen- 
so delle singole righe, ma in linea generale se 
avrete la pazienza di dare uno sguardo al file, 
concorderete che è abbastanza intuibile che in 
questo manifest vengono "dichiarate" le carat- 
teristiche essenziali di questo gadget. Tra le al- 
tre cose viene anche dichiarato che il file che 
contiene il "core" del gadget sarà "ciaomon- 
do.html". 



IL FILE CIAOMONDO 

Creiamo un file ciaomondo.html allo stesso li- 
vello del manifest riempiendolo con le seguen- 
ti istruzioni: 



<html> 


<head> 


<title> 


Ciac 


Mondo</title> 








</head> 


<body> 


<span 


id=' 


gadgetContent' 


>C 


ao 
Mond 


o</span> 


</body> 


</html> 



-XT 

I 



A questo punto il nostro primo gadget è pron- 
to. Non ci resta che cliccare sull'icona 



IL FILE MANIFEST 

All'interno della cartella ciaomondo.gadget crea- 
te un file chiamato gadget. xml e riempitelo con 
le seguenti istruzioni: 




<?xml version = "1.0" encoding = "utf-8" ?> 
<gadget> 
<name>Ciao Mondo</name> 



<namespace>ioProgrammo.samples 



</namespace> 



<version>1.0</version> 



per accedere al pannello di controllo dei wid- 
gets. 

e proseguire con l'installazione. 
È facile notare che il nostro nuovo widget com- 
pare fra quelli disponibili. Tuttavia cliccando 
due volte l'effetto sarà solo quello parzialmen- 
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te desiderato. Il widget comparirà nella Side- 
Bar ma l'etichetta ciao mondo sarà troppo spo- 
stata rispetto allo schermo ed inoltre lo sfondo 
non sarà trasparente. Esattamente come in fi- 
gura 4. 



OTTIMIZZAZIONI 

Iniziamo con il referenziare all'interno di eia- 
mondo. html un file .css contenente il foglio di 
stile per il gadget, come segue: 



<head> 


<title>Ciao 


Mondo</title> 




< link href= 


'styles/styles.css" type = "text/css" 
rel = "stylesheet" /> 


</head> 


<body> 


<span id = 


'gadgetContent' 


>Ciao 

Mondo</span> 


</body> 


</html> 



e ovviamente creiamo il corrispondente foglio 
di stile styles/styles.css 



BODY 



{ 



width:125; 



height:150; 



padding-top: 5px; 



} 



#gadgetContent 



{ 



font-family: Tahoma; 



font-size: lOpt; 




Figura 5: II gadget appa- 
re centrato dopo averlo 
sistemato con i fogli di 
stile 



<html> 



Adesso il risultato è decisamente accettabile. Il 




P j/-A tnìf^Lf PicoDisk 4CD è la chiave di memoria USB 2.0 Hi Speed dedicata alle software house che intendano rendere 

' t/I^IV u tj|j ZZa ij||j | e proprie applicazioni direttamente da una chiave USB. 

La memoria flash del dispositivo può infatti essere partizionata in 4 differenti tipologie di unità logiche più un'area 
nascosta, che verranno combinate dalla software house in base alle esigenze della propria applicazione, arrivando a 
supportare la coesistenza su un unico dispositivo di un massimo di 4 partizioni più l'eventuale hidden area, 
PicoDisk 4CD può essere un semplice Mass Storage opzionabilmente reso accessibile in sola lettura, un CD-ROM 
o entrambi, e può avere un'area di memoria completamente crittografata. 



www.eutronsec.it 
www.picodisk.com 
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nostro gadget appare centrato figura 5. Tutta- 
via non abbiamo ancora ottenuto l'effetto tra- 
sparenza. Questa è la parte più semplice. E' suf- 
ficiente creare una qualunque immagine tra- 
sparente al 100% e utilizzarla come background 
del file HTML. Possiamo referenziarla nel fo- 
glio di stile come segue: 

BODY 

{ 

width:125; 



height:150; 



padding-top: 5px; 



background: 

url('../images/Background.png'); 



#gadgetContent 



{ 



font-family: Tahoma; 



color: White; 



font-size: lOpt; 



Abbiamo anche cambiato il colore del font per 
ottenere un effetto consistente. Il nostro primo 
gadget è terminato! Il passo "Ciao Mondo" è 
compiuto, siamo ora pronti per qualcosa di più 
entusiasmante. 



IL MODELLO AD 
OGGETTI 

In realtà quello che abbiamo fatto fino ad ora è 
stato scrivere una pagina HTML, è evidente che 
all'interno di questa pagina posso convivere 
tutti gli elementi utilizzabili in IE7. Parliamo 
dunque, di FLASH, ActiveX , oggetti di sistema 
richiamabili da IE. Ad esempio modifichiamo 
il file ciamondo.html come segue 



<html> 


<head> 


<title>Ciao 


Mondo</title> 




< link href= 


'styles/styles.css" 
re 


type = "text/css" 
= "stylesheet" /> 




<script type = "text/javascript" 
src="scripts/ 


op.js"x/script> 




</head> 


<body onload = 


= "setContentText() 


> 


<span id = " 


gadgetContent">Ciao Mondo</div> 


</body> 


</html> 



Abbiamo cioè incluso un riferimento al file di 



script iop.js e agganciato all'evento onload del- 
la pagina la funzione setContentTextO in esso 
contenuta. Il file iop.js potrebbe contenere qual- 
cosa del genere: 

// JScript source code 
function setContentTextO { 

fso = new ActiveXObject 

( "Scripting. FileSystemObject" ); 

e = new Enumerator( fso.Drives ); 

gadgetContent.innerHTMI_="; 



for(; !e.atEnd(); e.moveNext() ) 



{ 



drive = e.item(); 



if ( drive. IsReady ) 



{ 



var total = Math. round 

( drive.TotalSize / 1048576 ); 
var free = Math. round 

( drive. FreeSpace / 1048576 ); 
var used = Math.round(total - free); 
gadgetContent.innerHTML 

+ = drive.DriveLetter+':<br>'; 
gadgetContent. in nerHTML+ = 'Spazio 

Totale:<br> '+total + '<br>'; 
gadgetContent. in nerHTML+ = 'Spazio 

Libero: <br> '+free + '<br>'; 
gadgetContent. in nerHTML+ = 'Spazio 

Usato:<br> ' + used + '<br>'; 



gadgetContent. in nerHTML+ = 



'Percent. usata: 



' + Math.round(( used / total)*100) + '%' 




Figura 6: le informazioni vengono mostrate 
nel gadget 
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} 



Abbiamo cioè usato gli oggetti di sistema per 
reperire le informazioni relative allo spazio di- 
sponibile e usato sui nostri HD e le abbiamo 
mostrate nel gadget. 
Il risultato è quello in figura 6. 
Non è certo graficamente bellissimo, ma non 
siamo qui per fare un corso di grafica e sicura- 
mente in molti di voi sapranno personalizzarlo 
nel migliore dei modi. Ciò che è importante ca- 
pire è che è possibile usare l'intero modello ad 
oggetti disponibile per IE7. 



<html> 



<head> 



<title>Ciao Mondo</title> 



< link href="styles/styles.css" type = 

"text/css" rel = "stylesheet" /> 

< script type = "text/javascript" 

src="scripts/iop.js"x/script> 



< script type = "text/javascript"> 



System. Gadget, setti ngsUI = "settings.html"; 
System. Gadget. onSettingsClosed = Setti ngsClosed; 



function SettingsClosed() { 



colore = System. Gadget. Setti ngs.read ("colore"); 



setContentText(); 



} 



</script> 




HTIM. 




E LE OPZIONI? 

Di solito gli utenti amano personalizzare i pro- 
pri gadget, e d'altra parte deve esistere un qual- 
cosa per poter inserire delle opzioni. Suppo- 
niamo ad esempio che l'utente voglia che il co- 
lore del testo del gadget che abbiamo appena 
appena sviluppato sia rosso invece che bianco. 
Come fare a interagire con un gadget? Ci viene 
in aiuto il metodo SettingsUI. Modifichiamo il 
file ciaomondo.html come segue: 



</head> 



<body onload = "setContentText()"> 



<span id = "gadgetContent">Ciao 



Mondo</span> 



</body> 



</html> 

Ok, ora tenetevi forte, il meccanismo è sempli- 
cissimo, ma entreremo in una girandola di file 
perciò abbiate la pazienza di seguire punto per 
punto. 




SmartPic# 



SmartPico è il dispositivo driverless che combina e fonde in un'unica chiave le caratteristiche di protezione per gli 
applicativi insite in SmartKey, insieme a quelle di praticità e trasporto dati tipiche di PicoDisk 4CD, 
Grazie a queste particolarità è possibile installare un applicativo su SmartPico ed eseguirlo direttamente dalla 
chiave senza dover installare nulla sul PC. La memoria è partizionabile in più dischi, uno dei quali può avere la 
funzionalità CD e quindi supportare l'autorun. 
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1) Con l'istruzione System. Gadget. setting- 
sUI="settings.html"; otteniamo due risulta- 
ti. Prima di tutto, da ora in poi, ogni volta che 
il gadget verrà caricato comparirà un segno 
di spunta alla sua estrema sinistra. Cliccan- 
do su questo segno di spunta apriremo una 
finestra di dialogo tramite la quale potremo 
fornire dei dati in input al gadget. Inoltre av- 
visiamo che tale finestra sarà definita all'interno 
del file settings.html 

2) Con l'istruzione System. Gadget. onSetting- 
sClosed=SettingsClosed; facciamo in modo 
che ogni volta che l'utente chiuderà la fine- 
stra di dialogo delle opzioni sia eseguita la 
funzione SettingsClosed 

3) Nella funzione SettingsClosed con le istru- 
zioni che seguono 



function SettingsClosed() { 


colore = System. Gadget. Setti ngs 


read( 


colore 


'); 


setContentText(); 


} 



Leggiamo il valore di una variabile associata al 
gadget e infine ridisegniamo la finestra con la 
funzione setContentText che avevamo prece- 
dentemente definito. Ok, fin qui non è troppo 
complicato. Dobbiamo ora gestire la finestra di dia- 
logo delle opzioni. Per farlo dovremo creare un 
file settings.html. Il suo contenuto è il seguente: 



<html> 


<head> 


<title>ioP Setting 


5</title> 


<style> 


body { 


width:250; 


heìght:75; 


} 


</style> 


<script type = "text/javascript" 

src="scripts/options.js"x/script> 


</head> 


<body onload = "init();' 


> 


<span id = "variabile 
TahomE 


" style = "font-family: 
;font-size: 10pt;">Colore 




<select id = "envVar 


> 


<option value 


white">Bianco</option> 


-coption value = 


'green "> Verde </option> 


<option value = 


'black">Nero</option> 


<option value = 


'red">Rosso</option> 


</select> 


</span> 


</body> 



</html> 

In questo file includiamo il sorgente options.js 
di cui parleremo fra un minuto e definiamo l'in- 
terfaccia della finestra di dialogo, semplice- 
mente aggiungendovi un combobox contenente 
un elenco di colori. Infine in relazione all'evento 
OnLoad della finestra di dialogo richiamiamo 
la funzione init() che appunto è contenuta in 
options.js. 
Il nostro option.js è il seguente: 

// JScript source code 



System. Gadget. onSettingsClosing 



settingsClosing; 



function initQ { 



cu rrentSetting = System. Gadget. Setti ngs. read 

("actualcol"); 



if (currentSetting ! = "") 



envVar.selected!ndex = currentSetting; 



} 



function settingsClosing(event) { 



if (event.closeAction = = 

event. Action. commit) { 



colore = envVar.value; 



actualcol = envVar.selected!ndex; 



System. Gadget. Setti ngs. write("colore", colore); 

System. Gadget. Setti ngs. write 

("actualcol", actualcol); 



} 



event. cancel=false; 



} 



In relazione all'evento OnLoad viene richiamata 
la funzione init() come già detto. In questa fun- 
zione si controlla se c'è qualche variabile ac- 
tualcol già definita, se c'è il combo delle opzio- 
ni viene settato alla variabile corrente. 
La funzione probabilmente più interessante è la 
settingsClosingOche viene richiamata quando 
la finestra di dialogo viene chiusa grazie all'i- 
struzione: 

System. Gadget. onSettingsClosing = 

OsettingsClosing; 

Nella settingsClosing si preleva il valore sele- 
zionato nella combo e lo si scrive fra le variabi- 
li globali che disponiamo per personalizzare il 
colore dei caratteri. Quando la finestra di dialogo 
viene chiusa, il controllo torna a ciaomondo.html 
che come abbiamo già visto recupera il valore del 
colore e ridisegna il contenuto della pagina con 
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una setContentTextO. 

Sembra veramente complicatissimo ma in realtà 
si tratta veramente di poche righe di codice. 
Una volta entrati nel meccanismo e capito co- 
me vanno disposti i file, vi accorgerete che si 
tratta veramente di operazioni piuttosto semplici 
sia sul piano semantico sia sintattico. 



DISTRIBUIRE 
UHI GADGET 

Il deployment è probabilmente la parte più sem- 
plice di tutta la faccenda. In realtà i file con 
estensione .gadget non sono altro che degli zip 
rinominati. Per cui creare un package per la di- 
stribuzione si riduce ai seguenti passi: 

1) Settate Windows Explorer in modo che ven- 
gano mostrare le estensioni anche per i file 
conosciuti 

2) Create una cartella compressa 

3) Trascinate i file associati con il gadget nella car- 
tella in questione 



4) Cambiate l'estensione della cartella da .zip 



a .gadget ed il gioco è fatto 

potete rendere disponibile il gadget con una 
delle forme conosciute: localmente, hard disk, 
email o qualunque altro tipo di applicazione 



CONCLUSIONI 

I gadget di Windows Vista non rappresentano cer- 
tamente una grande novità per il mondo del- 
l'informatica. Chi usa Linux o Mac da molto tem- 
po è abituato a meccanismi simili. Tuttavia si trat- 
ta di una di quelle comodità piccole ma sufficien- 
temente utili da garantire spazi di mercato enor- 
mi. In realtà avere un gadget presente sul desktop 
che segnala per esempio variazioni di mercato, di- 
sponibilità di magazzino, quotazioni di borsa o al- 
tre notizie utili per un'operatore, può rappresen- 
tare una soluzione non di poco conto. Tutto viene 
dunque demandando alla capacità diu un buon 
programmatore di integrare nelle proprie appli- 
cazioni i vari gadget. Non si tratta neanche di una 
tecnologia invasiva, perciò non è neanche neces- 
sario modificare codice preesistente. Si tratta per- 
ciò di quelle tecniche che devono entrare a far par- 
te del bagaglio tecnico di ogni buon programma- 
tore Windows. 





©Web 
/Authentication 



% 



WebAuthentication è la famiglia di dispositivi USB che permette di riconoscere ed autenticare univocamente 
l'utente di un'applicazione Web-based e di stabilire con esso transazioni protette e crittografate su reti Internet, 
Intranet, Extranet. Ideali per risolvere in modo semplice e funzionale i problemi di gestione e di replicabilità dei 
sistemi basati su user name e password e per migliorare l'usabilità e la sicurezza dei dispositivi OTP tradizionali. 
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USARE AJAX NEI 
DISPOSITIVI MOBILI 

L'ULTIMA MODA NELL'AMBITO DELLO SVILUPPO DI APPLICAZIONI WEB È SICURAMENTE AJAX. 
IMPARIAMO AD UTILIZZARE QUESTA TECNOLOGIA INNOVATIVA ANCHE NEI BROWSER DEI 
CELLULARI, CHE TIPICAMENTE IMPONGONO QUALCHE RESTRIZIONE... 




in 




REQUISITI 



Conoscenze richieste 



— Conoscenze Richieste: 
LJ C#, Visual Studio 2005 



Windows XP, 
ActiveSync 4. ì, 
Microsoft Device 
Emulator, Visual Studio 
2005 



0000 



Negli ultimi mesi si è molto parlato di argo- 
menti qualile "chiamate asincrone" oppure 
"AJAX" o anche "ATLAS". Tutti questi argo- 
menti afferiscono alla possibilità di migliorare enor- 
memente l'esperienza dell'utente (user experience), 
dato che li loro utilizzo consente l'aggiornamento di 
pagine web in modo parziale, evitando vecchio mo- 
dello di "post-back" dove la pagina viene aggiornata 
nella sua totalità. 

Queste nuove tecniche di aggiornamento si basano 
su Javascript e sul modello ad oggetti del navigatore (Do- 
cument Object Model - DOM), consentono di effettuare 
chiamate asincrone ad una risorsa sul server web e 
conseguentemente processare le relativa risposta. 
Sul versante desktop si è già potuto notare il fiorire di 
numerosi framework per lo sviluppo di soluzioni 
"AJAX-based" ; tra tutti possiamo citare la recente usci- 
ta del framework di Microsoft, ASRNET AJAX (già no- 
to come ATLAS) che mette a disposizione degli svi- 
luppatori tutta una serie di strumenti lato server che 
consentono lo sviluppo di applicazioni complete, sen- 
za (quasi) dover scrivere una linea di codice. A tutt' og- 
gi questi potenti strumenti si appoggiano sulle pos- 
sibilità offerte dai navigatori installati su macchine 
desktop. Furtroppo il discorso cambia notevolmente 
se parliamo di navigatori installati su dispositivi mo- 
bili. Fer ovvie ragioni, questi ultimi supportano un 
modello ad oggetti (Document Object Model - DOM) 
più "povero" rispetto alle rispettive versioni desktop; 
per tale ragione le soluzioni implementate, utilizzan- 
do gli attuali framework di sviluppo, non rendono 
usufruibili le applicazioni dai dispositivi mobili. 
In realtà è proprio nell'ambito dei dispositivi mobili che 
bisognerebbe concentrare lo sviluppo di applicazio- 
ni che ottimizzano il flusso dei dati via etere; sia per ra- 
gioni di "banda" dato che, in attesa del HSDFA, l'attuale 
copertura UMTS raramente consente una velocità 
apprezzabile e la velocità media consentita dalla rete 
GFRS è paragonabile a quella consentita dai vecchi 
modem analogici che utilizzavamo in casa prima del- 
l' avvento dell 'ADSL. Un ulteriore aspetto da tenere in 
considerazione è quello economico dato che il costo 
delle connessioni mobili, in genere, viene calcolato 
sul traffico; quindi minori saranno i dati che scam- 



biamo con il server, minore sarà il peso della bolletta. 
Fremesso quanto sopra, sarà sicuramente interes- 
sante leggere il seguente articolo, dove vedremo come 
utilizzare AJAX per creare applicazioni web usufrui- 
bili anche dai dispositivi mobili. 



LE FONDAMENTA 
DI AJAX 

Alla base di tutto ciò che possiamo sviluppare in AJAX, 
c'è un particolare oggetto implementato nel model- 
lo ad oggetti (Document Object Model - DOM) del 
navigatore: XmlHttpRequest. Questo oggetto, in ve- 
rità, non è una novità tecnologica degli ultimi tempi, 
dato che fu implementato la prima volta dalla Mi- 
crosoft che lo introdusse in Internet Explorer 5. Il grup- 
po di sviluppo di Mozilla (su cui si basa il navigatore 
FireFox) e Opera Software (produttore dell'omonimo 
navigatore) seguirono a breve. 
In ambito mobile, la disponibilità di navigatori è si- 
curamente maggiore rispetto all'ambito desktop. Si- 
curamente ci sono alcuni prodotti che hanno il van- 
taggio di essere gratuiti ed installati nelle ROM dei di- 
spositivi (Internet Explorer Mobile su piattaforma Mi- 
crosoft, piuttosto che Blazer nei dispositivi Treo), ma 
altri prodotti si battono tenacemente in un mercato che 
non è così monopolizzato come nell'ambito desktop 
(possiamo citare ad esempio Opera Mobile piuttosto 
cheNetFront). 

Qualsiasi sia il navigatore installato sul nostro dispo- 
sitivo, affinché questo possa usufruire di applicazio- 
ni basate su AJAX, questo deve supportare l'oggetto 
XmlHttpRequest. Di seguito vediamo quanto sia sem- 
plice verificare questa caratteristica. 



L'OGGETTO 
XMLHTTPREQUEST 

Per verificare se il nostro navigatore preferito sup- 
porta AJAX, è sufficiente provare a creare, in una fun- 
zione Javascript, una istanza dell'oggetto XmlHtt- 
pRequest. Detta in questi termini la cosa sembra 
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alquanto semplice da verificare; in realtà dobbia- 
mo prima capire "in che modo" il navigatore espo- 
ne (eventualmente) l'oggetto. 
Se il navigatore supporta in modo nativo l'ogget- 
to, l'istruzione da testare sarà: 

request = new XMLHttpRequest(); 

In ambiente Windows Mobile la situazione è leg- 
germente differente dato che Pocket Internet Ex- 
plorer (o Internet Explorer Mobile, che dir si vo- 
glia) supporta XmlHttp Request come oggetto Ac- 
tiveX; non solo, nel passaggio dalla versione Win- 
dows Mobile 2003 Second Edition alla versione 
Windows Mobile 5 del sistema operativo, il navigatore 
ha avuto delle evoluzioni, specialmente nel mo- 
dello ad oggetti; anche il supporto all'oggetto 
XmlHttpRequest ha subito un cambiamento, quin- 
di se vogliamo creare una istanza in ambiente Win- 
dows Mobile 2003 Second Edition dovremo scrivere 
la seguente istruzione: 

request = new ActiveXObject("Microsoft. XMLHTTP"); 

In ambiente Windows Mobile 5 invece l'istruzione 
sarà: 

request = new ActiveXObject("Msxml2. XMLHTTP"); 

Se mettiamo assieme le varie opzioni, possiamo 
creare una semplice applicazione "cross-browser" 
in grado di verificare su qualsiasi navigatore in- 
stallato sul nostro dispositivo l'eventuale suppor- 
to dell'oggetto XmlHttpRequest. 





Request 


tramite Microsoft.XMLHTTP"); 


} catch (error) { 


request = false; 


} 


} 


} 


if (! request) 




alert("Questo Navi 


gatore 


non supporta XMLHttp 
Request!"); 


return request; 


} 



Se incapsuliamo la precedente funzione in una 
pagina HTML in cui poniamo un solo bottone che 
esegue la suddetta funzione, abbiamo creato un 
semplice tool per verificare se il nostro navigato- 
re preferito supporta l'oggetto XmlHttpRequest. 



<body> 



<form id = "forml" runat="server"> 



<table align = "center"> 



<trxtd colspan = "2" align = "center"> 



<h2>Test AJAX</h2> 



</tdx/tr> 



<trxtd align = "center"> 



<input type = "Button" Value="Test AJAX" 

OnClick="Javascript:CreateRequest();" /> 

</td> 

<td align = "left"ximg src="SmartAjax.gif" 

/x/td> 

</tr> 
</table> 
</form> 




MICROSOFT 

DEVICE 

EMULATOR 

Microsoft Device 
Emulator è compreso 
in Microsoft Visual 
Studio 2005 oppure è 
possibile scaricarlo dal 
sito Microsoft a par- 
tire dall'indirizzo 
http://msdn.microsoft. 
com/mobility/win- 
dowsmobile/down- 
loads/default.aspx 
dove è possibile scari- 
care anche l'SDK di 
Windows Mobile 5.0 
per Pocket PC e per 
Smartphone; questo 
componente aggiunge 
gli emulatori per la 
piattaforma Windows 
Mobile 5.0 al Device 
Emulator. 



</body> 



var request; 



function CreateRequest() 



{ 



request = false; 



try { 



// Navigatore con supporto nativo 



request = new XMLHttpRequest(); 



alert("Questo Navigatore supporta XMLHttp 



Request in modo nativo."); 



} catch (PIE5) { 



try { 



// Internet Explorer su Windows Mobile 5 
request = new ActiveXObject("Msxml2. 

XMLHTTP"); 
alert("Questo Navigatore supporta XMLHttp 

Request tramite Msxml2. XMLHTTP"); 
} catch (PIE2003) { 

try { 

// Internet Explorer su Windows Mobile 2003 

Second Edition 
request = new ActiveXObject 

("Microsoft.XMLHTTP"); 
alert("Questo Navigatore supporta XMLHttp 



Premesso che per mostrare i risultati del lavoro 
svolto nel presente articolo verrà utilizzato il pro- 
dotto Microsoft Device Emulator, nella figura se- 
guente possiamo vedere il test effettuato rispetti- 
vamente su Pocket Internet Explorer su piattafor- 
ma Windows Mobile 2003 Second Edition per 
Smartphone e su Internet Explorer Mobile su piat- 



Alert 



J 1 |http://10.6.g7.74/smartA)ait/tes~^1 (» 

Test AJAX 



Questo Navigatore supporta 
XMLHttpRequest tramite 
Microsoft.XMLtFFTT r 



r 



't 



Questo Navigatore 
supporta XMLHttpRequest 
tramite Ms»ml2. XMLHTTP 



Fig. 1: II navigatore incorporato nei dispositivi basati 
sulle ultime versioni di Windows Mobile (2003SE e 5) 
supporta AJAX. 
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Il navigatore Opera 

Mobile è scaricabile, 

nelle sue innumerevoli 

versioni, a partire 

dall'indirizzo: 

http://www,opera.com/pr 

oducts/mobile/products/. 

Il navigatore NetFront 

è scaricabile, nelle sue 

innumerevoli versioni 

a partire dall'indirizzo: 

http ://www, access- 

company.com/products/ne 

tfrontmobile/browser/34 

wm tp.html . 



taf orma Windows Mobile 5 per Pocket PC (È pos- 
sibile reperire la pagina testAJAX.htm nei file di 
supporto all'articolo). 

In Figura 2 invece vediamo come navigatori di ter- 
ze parti supportino l'oggetto XmlHttpRequest in mo- 
do nativo; il test è stato effettuato utilizzando ri- 
spettivamente Opera Mobile 8.6u2 e NetFront 3.4 



£ 10:39 / m I NetFront v3.4 ++ -^ 1 1:00 



X http:Jfl0.6.97.74/smartAr * % _| ||http://10.6.97,74/smartAjax/t -\ ft; 



Test a:ax 



l 



% 



Questo Navigatore 
f\\ supporta XMLHttpRequest 
in modo nativo. 



Te3t AJAX 



Questo Navigatore supporta 
XMLHttpRequest in modo nativo. 



| | Disable JavaScript on this page 



Fig. 2: lOpera Mobile e NetFront supportano AJAX in 
modo nativo. 



CONFIGURAZIONE ED 
INVIO DELLA RICHIESTA 

Dopo aver verificato che il nostro browser supporta l'og- 
getto XmlHttpRequest, possiamo compiere un pas- 
so in avanti e realizzare un primo colloquio tra il na- 
vigatore ed una risorsa sul web. Fortunatamente l'og- 
getto XmlHttpRequest è relativamente semplice e ci 
consente di costruire una infrastruttura basata su 
AJAX con pochi metodi e proprietà. 
Al fine di costruire una infrastruttura modulare e, 
quindi, riusabile in diverse pagine, costruiamo una 
funzione Javascript in cui supponiamo che l'indiriz- 
zo della risorsa web con cui interloquire venga pas- 
sata come parametro. 

All'interno della funzione Javascript, creiamo innan- 
zitutto l'oggetto XmlHttpRequest utilizzando una fun- 
zione analoga a quella vista in precedenza: 

xmlHttpReq = CreateRequestQ; 



specificare un nome utente nel quarto parametro 
e la relativa password nel quinto parametro. 
Prima di inviare la richiesta al server dobbiamo an- 
cora definire il meccanismo di "cali-back" in modo 
che il server sia in grado di inviare le informazioni ri- 
chieste, al navigatore. 

Per ora ci occupiamo di agganciare alla richiesta 
una funzione, che verrà invocata una volta che i da- 
ti saranno disponibili. Dobbiamo valorizzare la pro- 
prietà onreadystatechange dell'oggetto XmlHtt- 
pRequest che rappresenta il gestore dell'evento as- 
sociato alla variazione dello stato della richiesta; va- 
lorizziamo la proprietà con il nome della funzione 
che vogliamo utilizzare come gestore della risposta 
del server (la funzione è descritta nella prossima se- 
zione). 

xmlHttpReq. onreadystatechange = ManageResponse; 

Come ultima operazione dobbiamo inviare la richie- 
sta al server; utilizziamo il metodo send() dell'ogget- 
to XmlHttpRequest a cui si può passare opzional- 
mente un parametro per inviare contenuto al server: 



xmlHttpReq. send(null); 

È possibile altresì inviare parametri sulla linea di co- 
mando, compilando opportunamente l'URL della ri- 
chiesta. 
Di seguito la funzione SendRequest(). 

function SendRequest(url) 

1 

// Creiamo l'oggetto XmlHttpRequest 
xmlHttpReq = CreateRequest(); 
// Configuriamo la richiesta 
xmlHttpReq. open("GET", uri, true); 
// Impostiamo la funzione di cali-back 
xmlHttpReq. onreadystatechange = 

ManageResponse 
// Inviamo la richiesta al server 
xmlHttpReq. send(null); 
} 



Dobbiamo altresì configurare la richiesta; lo possiamo 
fare utilizzando il metodo openO dell'oggetto XmlHtt- 
pRequest, a cui passiamo, come primo parametro, il 
tipo di richiesta (che può essere "GET" o "POST"); co- 
me secondo parametro, l'indirizzo della risorsa web a 
cui connettersi; come terzo parametro un valore boo- 
leano che, se valorizzato a true, indica che la richiesta 
sarà asincrona. 

xmlHttpReq. open("GET", uri, true); 

Nel caso in cui la risorsa a cui ci connettiamo ne- 
cessiti di autenticazione, possiamo utilizzare la ver- 
sione a 5 parametri del metodo open(); potremo 



Gestione della risposta del server 
Per gestire la risposta del server alla nostra richiesta, 
dobbiamo implementare la funzione che viene invo- 
cata ogni volta che varia lo stato della richiesta. 
Lo stato della richiesta può assumere valori che van- 
no da (uninitialized) a 4 (complete) secondo la tabella 
seguente: 



/'Stato 


Descrizione "^ 





uninitialized 


1 


loading 


2 


loaded 


3 


interactive 




Complete 
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Chiaramente l'elaborazione dei dati deve avvenire 
solo dopo che la richiesta ha raggiunto lo stato " com- 
plete". 

if (xmlHttpReq.readyState == 4) 

Prima di procedere nell'analisi della risposta, è ne- 
cessario verificare che l'interazione non abbia gene- 
rato errori. Attraverso le proprietà status e statusText 
possiamo verificare il codice di ritorno della richiesta 
HTTP II codice 200 (il cui relativo valore testuale è 
"OK") ci segnala che il colloquio non ha generato er- 
rori quindi possiamo elaborare la risposta. 

if (xmlHttpReq. status == 200) 

In caso di errore lo stato verrà valorizzato con i valo- 
ri che a volte riscontriamo durante la navigazione: 
500 ("Internai Server Errar"), 404 ("NotFound"), ecc. 
L' oggetto XmlHttpRequest mette a disposizione due 
proprietà attraverso cui possiamo elaborare la rispo- 
sta del server: responseText contiene la risposta del 
server in formato stringa mentre responseXML con- 
tiene la risposta del server in formato XML, in particolare, 
se la risorsa invocata è un web service, il documento 
XML ritornato, rappresenta messaggio SOAP invia- 
to dal server. 

UpdatePage(xmlHttpReq. responseText); 

Nell'esempio conente la nostra funzione passerà sem- 
plicemente il contenuto della risposta ad una fun- 
zione che dovrà essere implementata al livello della 
pagina chiamante. 

function ManageResponse() 

{ 

// Verifichiamo che la richiesta sia completata 
if (xmlHttpReq.readyState == 4) 

{ 

// Verifichiamo che il colloquio non abbia generato 

errori 
if (xmlHttpReq. status == 200) 

{ 

// Passiamo la risposta del server ad una 
funzione che gestirà il risultato al livello della pagina 
UpdatePage(xmlHttpReq. responseText); 
} 



AJAX ENGINE 

A questo punto della trattazione possiamo effettuare 
un piccolo riassunto per constatare che, così come 
abbiamo strutturato le funzioni, abbiamo creato in 
realtà un "motore" AIAXmodulare e riusabile. In in- 



put al nostro motore va l'indirizzo (completo di even- 
tuali parametri) della risorsa web che andremo ad in- 
terrogare; l' output della richiesta verrà passato ad una 
funzione (UpdatePage) che dovrà essere implemen- 
tata in ogni pagina che utilizzerà il nostro motore. 
In teoria, proprio per rendere il nostro motore riusa- 
bile, potremmo porre le tre funzioni all'interno di un 
file (ad esempio AIAXEngine.js) che potrebbe essere 
semplicemente linkato in ogni pagina con la seguen- 
te istruzione: 

<script language="javascript" src="AJAXEngine.js"> 

</script> 

Purtroppo i navigatori mobili sembrano non "inten- 
dere" questa direttiva quindi dovremo copiare il codice 
sviluppato finora in tutte le pagine che intendiamo 
rendere "AJAX-based". 



L'AGGIORNAMENTO 
PARZIALE 

Finora abbiamo costruito una infrastruttura che 
gestisce in tutto e per tutto la comunicazione 
asincrona tra il nostro navigatore ed una qual- 
sivoglia risorsa web; non abbiamo dedicato nes- 
suna parola all'aggiornamento dinamico delle 
pagine, alla possibilità di aggiornare solo parti 
e non l'itera pagina. 

Con XmlHttpRequest gestiamo la comunica- 
zione asincrona tra client (il nostro navigatore, 
ma non solo) ed una risorsa web. L'aggiorna- 
mento o meglio l'elaborazione della risposta del 
server è compito del codice lato client che, uti- 
lizzando gli oggetti messi a disposizione del DOM 
(Document Object Model), "inietta" i dati nella 
pagina, andando ad aggiornare le parti rilevan- 
ti della stessa. 

È proprio questa la ragione che limita (almeno ad 
oggi) l'utilizzo dei framework di sviluppo di ap- 
plicazioni "AJAX-based" sui dispositivi mobili, 
ovvero l'utilizzo di oggetti che sono messi a di- 
sposizione dai DOM dei navigatori utilizzati nel- 
le postazioni desktop, ma che purtroppo non 
trovano corrispondenza nei DOM messi a di- 
sposizione dai navigatori in ambito mobile. 
Avere ben chiare quali siano le dotazioni "mini- 
me" messe a disposizione dagli strumenti "tar- 
get" della nostra applicazione è fondamentale 
per ottenere la maggior fruibilità possibile. 
Ad esempio è importante sapere che le proprietà 
innerText ed innerHTML sono supportate in am- 
biente Windows Mobile 2003 Second Edition SO- 
LO dagli elementi <div> e <span> mentre sono 
supportate in tutti gli elementi su piattaforma 
Windows Mobile 5. La speranza è ovviamente 
affidata alla evoluzione dei framework di svi- 
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DOVE TROVO 
L'EMULATORE! 

Microsoft Device Emù- 
lator è compreso in Mi- 
crosoft Visual Studio 
2005 oppure è possibi- 
le scaricarlo dal sito 
Microsoft a partire dal- 
l'indirizzo 
http://msdn.microsoft,com 
Anobi litv/windowsmobile 
/downloads/default.aspx 
dove è possibile scari- 
care anche l'SDK di 
Windows Mobile 5.0 
per Pocket PC e per 
Smartphone; questo 
componente aggiunge 
gli emulatori per la 
piattaforma Windows 
Mobile 5.0 al Device 
Emulator. 



luppo auspicando il supporto anche dei dispo- 
sitivi mobili nelle prossime versioni. 



UM PRIMO ESEMPIO 

Per chiudere il cerchio, ovvero per testare la no- 
stra prima interazione AJAX, dobbiamo creare una 
risorsa web che, se interrogata, ci restituisca dei 
dati. 

Come primo esempio utilizzeremo una semplice 
pagina aspx che restituisce la data di sistema (un 
esempio più complesso verrà trattato più avanti 
nella trattazione). 

La pagina da caricare è FirstReq.htm ed è compo- 
sta da un bottone che invoca la risorsa tramite 
AJAX, ed un elemento <div> in cui andremo a stam- 
pare la data. 



<body> 


<form id = "forml" runat 


= "server" > 




<table align="center 


> 






<trxtd colspan = "2' 


align = 


'center"> 




<h2>Primo Esempio 


AJAX</h2> 




</tdx/tr> 


<trxtd align = "center"> 


<input type="Button 


Value 


= "Scarica Data 




OnClick= 


'Javascript : GetDate() ; 


"/> 


</td> 


<td align="left"xim 


g src=' 


SmartAjax.gif 


/> 






< 


'td> 


</tr> 


<trxtd colspan = "2' 


align = 


'center"> 




La data di sistema è: 


<br/> 






<div id = "divSysDate' 


align = 


"center"x/div> 


</tdx/tr> 


</table> 


</form> 


</body> 



Per quanto riguarda il codice Javascript, oltre al 
motore AJAX, definiamo una funzione GetDateO che 
semplicemente incapsula la richiesta al server, e 
la funzione "obbligatoria" UpdatePageO per stam- 
pare la data del server nel suddetto elemento <div> 
della pagina. 



Nella funzione GetDateO possiamo notare che l'in- 
dirizzo verso cui effettuiamo la richiesta (Fir- 
stReq.aspx), è definito senza specificare per inte- 
ro il protocollo ed il dominio (http://www.0Tuo- 
Dominio.it/ FirstReq.aspx); questa cosa non è frut- 
to di una dimenticanza ma è frutto del modello di 
sicurezza di AJAX (cosiddetto a "SandBox") che 
consente di inviare le richieste SOLO al dominio in 
è eseguito. Ciò significa che se invochiamo la pa- 
gina FirstReq.htm dal nostro desktop, potremo in- 
vocare solo risorse presenti nel nostro desktop; 
analogamente, se invochiamo una pagina me- 
morizzata in http://www.ilTuoDominio.it, potre- 
mo invocare solo risorse presenti in http: / / www.il- 
TuoDominio.it. Lato server, la pagina che fungerà 
da risorsa web è FirstReq.aspx. Nel codice esegui- 
to al caricamento della pagina (Page_Load()), dob- 
biamo semplicemente stampare in output il valo- 
re della data. Quindi dobbiamo terminare l'ese- 
cuzione della pagina dato che tutti i dati necessa- 
ri sono stati inviati. 



protected void Page_ 


_Load(object sender. 


EventArgs 


e) 


{ 




Response 


Write(DateTime.Now.ToStringO); 






Response 


End(); 








} 



Nella figura seguente andiamo a verificare il fun- 
zionamento della nostra infrastruttura utilizzan- 
do Pocket Internet Explorer, Opera Mobile e Net- 
Front, tutti su piattaforma Windows Mobile 5. 
Chiaramente dalla figura non è possibile consta- 
tare come la pagina venga aggiornata SENZA ri- 
caricare né gli elementi grafici né il bottone. 
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Fig. 3: La nostra prima interazione AJAX. 



<script language="javascript"> 



function GetDateO 



{ 



SendRequest(' FirstReq.aspx'); 



} 



function UpdatePage(result) 



{ 



divSysDate.innerHTML = result; 



} 



</script> 



ATTENZIONE Al FILE 
TEMPORANEI!!! 

Prima di proseguire con un esempio più com- 
plesso, è il caso di osservare innanzitutto coma la 
stessa pagina venga mostrata in modo "abbastan- 
za" diverso nei tre navigatori (addirittura Opera 
Mobile manda alla riga successiva l'immagine). 
Questo ci serva solo come "appunto" da tenere a men- 
te per tutte le successive applicazioni che svilup- 
peremo: l'uniformità di presentazione delle pagi- 
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ne nei dispositivi mobili è realmente ancora una chi- 
mera. Una seconda cosa da evidenziare in questo 
esempio, è il comportamento assolutamente di- 
verso dei tre navigatori nei confronti dei dati me- 
morizzati nei file temporanei. 
Se noi proviamo ad eseguire il codice così come 
definito nella sezione precedente, avremo i se- 
guenti comportamenti: 

• Internet Explorer: Dopo aver caricato la prima 
volta la data NON c'è verso di aggiornarla; pre- 
mendo ripetutamente il tasto "Scarica Data", il 
valore resta inalterato. Anche se proviamo ad eli- 
minare i file temporanei, il risultato non cambia. 
Per avere un nuovo valore è necessario TERMINARE 
il programma (non premendo la "X" in alto a de- 
stra ma andando in Impostazioni->Sistema->Me- 
moria->Programmi in esecuzione per terminare 
Internet Explorer). 

• Opera Mobile: Dopo aver caricato la prima volta 
la data, il valore resta inalterato finché non eli- 
miniamo i file temporanei (menu->Tools->Settings- 
>History->clear cache) . 

• NetFront: Il programma si comporta corretta- 
mente senza alcuna modifica. 

Questi comportamenti sono dovuti ad una ge- 
stione "particolare" dei file temporanei in cui (evi- 
dentemente) i tre navigatori si differenziano. 
Per ovviare a questo problema dobbiamo evitare che 
la pagina venga posta in "cache" ovvero non deve 
rimanere traccia nei file temporanei del disposi- 
tivo. Il codice da inserire, allora, nella risorsa web 
(ovvero nella pagina FirstReq.aspx) sarà: 



<body> 



<form id = "forml" runat="server"> 



protected void Page_Load(object sender, 


EventArgs e) 


{ 




Response 


CacheControl = "no-cache 


"; 




Response 


AddHeader("Pragma", "no 


-cache"); 




Response 


Expires = -1; 






Response 


Write(DateTime.Now.ToStringO); 




Response 


End(); 




} 



Le prime tre righe effettivamente evitano che la 
pagina resti memorizzata, con questa modifica il 
codice funziona perfettamente in ogni navigatore. 



uni ESEMPIO 
PIÙ COMPLESSO 

Nel secondo esempio interrogheremo una base 
dati passando anche un parametro. 
Fermo restando che il motore AJAX utilizzato è 
esattamente lo stesso dell'esempio precedente, 
concentriamoci sulla pagina SecondReq.htm il cui 
corpo è riportato di seguito: 



<table align = "center"> 



<trxtd colspan = "2" align = "center"> 
<h2>AJAX nei Dispositivi Mobili</h2> 
</tdx/tr> 



<trxtd align="center"> 



<select id = "DropDownListl"> 



<option value="M"> Maschi </option> 
<option value="F">Femmine</option> 



</select> 



<input type="Button" Value="Cerca Impiegati" 
OnClick="Javascript:GetEmployees(Drop 

DownListl);" /> 

</td> 

<td align = "left"ximg src="SmartAjax.gif" /> 

</td> 

</tr> 

<trxtd colspan = "2"> 
<div id = "divEmployees"x/div> 
</tdx/tr> 
</table> 
</form> 
</body> 



L'obiettivo è quello di interrogare una tabella del 
database di esempi AdventureWorks incorporato 
in Microsoft Sql Server 2005. In particolare si vuol 
ottenere la lista dei dipendenti di sesso maschile o 
femminile a partire dalla selezione della relativa 
voce presente nella lista a cascata. 
La pressione del bottone "Cerca Impiegati" invo- 
ca la funzione Tavascript GetEmployees(): 

function GetEmployees(obj) 

{ 

divEmployees.innerHTML = "Invio richiesta in 

corso ..."; 



SendRequest('GetList.aspx?gender=' + obj. 



value); 



} 



Come possiamo vedere dal codice precedente, pri- 
ma di inviare la richiesta al server (SendRequestO) 
dobbiamo informare l'utente che una richiesta è 
in corso; questo perché, visto che la richiesta è 
asincrona, la pagina continua ad essere "attiva" 
durante l'interazione. In generale è buona norma 
informare l'utente che alcune operazioni sono in 
corso, in modo che la pagina apparentemente 
"inattiva" non lo disorienti. Sul server viene invo- 
cata la pagina aspx nominata GetList.aspx. Anche 
in questo caso tutta la logica applicativa è conte- 
nuta nel metodo di gestione del caricamento del- 
la pagina (Page_Load()). 

public partial class GetList : System. Web. UI. Page 
{ 
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private string strConnString 



Configuration Manager. ConnectionStrings[" DB 

ConnectionString"].ConnectìonString; 

protected void Page_Load(object sender, Event 

Args e) 



{ 



// Reperiamo il parametro dalla stringa in input 
string strGender = Request.QueryString 

["gender"]; 
// Definiamo la connessione al DB 
SqlConnection oConn = new SqlConnection 

(strConnString); 
// Definiamo il comando da inviare al DB 
SqlCommand oRetCommand = new Sql 

Command(); 
// Compiliamo la stringa che rappresenta 

l'interrogazione 
string strCommandText = "SELECT ISNULL 
(c.Title, ")+''+ ISNULL(c.FirstName, ") + '' + " + 
"ISNULL(c.Lastl\lame, ") AS Employee, 

c.EmailAddress as EMail " + 
"FROM Person. Contact e " + 
"inner join HumanResources. Employee e ON 
c.Contactld = e.Contactld " + 
"where e.Gender='" + strGender + '";"; 
// Imponiamo il testo del comando e la 

connessione 



oRetCommand.CommandText 



strCommand 

Text; 



oRetCommand. Connection = oConn; 
// Scarichiamo i dati su di un DataSet 
SqlDataAdapter oSqlDataAdapter = new Sql 

DataAdapter(oRetCommand); 



DataSet ds = new DataSet(); 



oSqlDataAdapter. Fill(ds, "dataSet"); 



// Creiamo un oggetto di tipo GridView 



GridView gv = new GridView(); 




Per eseguire il codice del secondo esempio, possiamo scaricare Microsoft 
Sql Server 2005 Express Edition dall'indirizzo: 

http://www.microsoft.com/downloads/details. aspx?familvid=220549b5-0b07-4448- 



8848-dcc397514b41&displaylang=en mentre il database di esempi 



AdventureWorks è scaricabile dall'indirizzo: 

http://www.microsoft.com/downloads/details. aspx?f amilvid=9697AAAA-AD4B- 



416E-87A4-A8B154F92787&displaylang=en. Ricordiamoci di definire una login 
in Sql Server coerentemente con quella definita nel file web.conf ig per 
accedere ai dati e che troviamo nei file di supporto all'articolo. Altrimenti 
ricordiamoci di cambiare la stringa di connessione in modo da poter 
accedere ai dati. 
<connectionStrings> 
<add name="DBConnectionString" 

connectionString="Data Source=(local);Initial Catalog= AdventureWorks; 
User ID=adWorksUser;Password=passguor" 
providerName="System.Data.SqlClient" /> 
</connectionStrings> 



// Valorizziamo la sorgente dati al DataSet 

appena creato 
gv.DataSource = ds; 
// Effettuiamo il bind dei dati 



gv.DataBind(); 



HtmITextWriter htw 



new HtmITextWriter 

(Response. Output); 



// Inviamo i dati al client 



gv.RenderControl(htw); 



Response. End(); 



} 



Come possiamo notare dal codice precedente, co- 
me prima cosa ricaviamo il parametro dalla linea di 
comando (per semplicità non vengono fatti controlli 
per la validazione dell' input; in un ambiente di prò - 
duzione è assolutamente necessario validare l'input 
a maggior ragione se la nostra applicazione è espo- 
sta su Internet). Di seguito si stabilisce una connes- 
sione al database, quindi si esegue la richiesta, il cui 
risultato è immagazzinato in un oggetto di tipo Da- 
taSet (anche in questo caso, per semplicità viene 
compilata la richiesta in modo testuale nel codice; 
in ambiente di produzione è buona norma usare le 
stored procedure) . A questo punto i dati che ci servono 
sarebbero pronti per essere inviati alla pagina che li 
ha richiesti. In verità, in questo esempio, vediamo 
come sia possibile farci "aiutare" dal server non so- 
lo nel reperimento dei dati, ma anche nella loro for- 
mattazione. Creiamo un oggetto di tipo GridView e 
lo accoppiamo con il DataSet appena creato 



// Creiamo un oggetto di tipo GridView 

GridView gv = new GridView(); 

// Valorizziamo la sorgente dati al DataSet appena 

creato 



gv.DataSource = ds; 



// Effettuiamo il bind dei dati 



gv.DataBind(); 



Creiamo un oggetto HtmITextWriter e definiamo 
come destinazione dei dati, proprio il flusso in 
uscita ovvero il flusso che ricondurrà i dati alla pa- 
gina che ne ha fatto richiesta. 

HtmITextWriter htw = new HtmlTextWriter(Response. 

Output); 



~~ "" ■ 




Fig. 4: Un esempio più complesso. 
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Infine utilizziamo il metodo RenderControl del- 
l'oggetto GridView che non fa altro che river- 
sare nel flusso di uscita il codice HTML che rap- 
presenta la formattazione grafica dell'oggetto 
GridView, ovvero una struttura <table> (una ta- 
bella). 

// Inviamo i dati al client 
gv. RenderControl (htw); 

Nell'immagine seguente possiamo vedere i vari pas- 
si dell'interazione tratti dai tre navigatori che abbia- 
mo scelto di utilizzare. Apriamo la pagina con Ope- 
ra Mobile, lanciamo l'interazione con NetFront, ve- 
diamo il risultato su Internet Explorer. 
Come ultima annotazione, possiamo notare che in 
questo caso non si presenta il problema rilevato nel- 
l'esempio precedente e relativo alla persistenza del- 
la pagina nei file temporanei (con relativo mancato 
aggiornamento). 

Probabilmente, visto che la pagina varia "abbastan- 
za", i navigatori si accorgono della variazione ed ef- 
fettuano correttamente l'aggiornamento. Ovvia- 
mente mancando una certezza assoluta è consiglia- 
bile provare il nostro lavoro su più piattaforme e su 
più navigatori (almeno quelli che supponiamo ven- 
gano utilizzati dai nostri utenti). 



ALCUNE 
CONSIDERAZIONI 

Il codice dell'esempio appena visto ci porta a fare al- 
cune considerazioni: sicuramente, l'aver utilizzato 
i "tool" messi a disposizione dal server ed, in questo 
caso, da ASP.NET 2.0 (l'oggetto GridView è appunto 
stato introdotto nella versione 2.0 del framework), 
ci ha consentito di "lavorare" molto meno lato client 
dato che i dati ci arrivano già formattati e quel che 
dobbiamo fare non è nient'altro che valorizzare un 
elemento <div> con ciò che ci proviene dal server. 
D'altro canto però in questo modo abbiamo violato 
il principio secondo cui è buona norma sviluppare co- 
dice su livelli indipendenti, disaccoppiando l'accesso 
ai dati dalla logica applicativa e, a maggior ragione, 
dall'interfaccia utente. È pur vero che formattare una 
tabella da codice client è un "lavoro" che per il pro- 
cessore di un dispositivo mobile (ricordiamoci che que- 
sto codice può lavorare anche su di uno smartpho- 
ne) potrebbe non essere indifferente, soprattutto se 
la tabella ha dimensioni notevoli. Indubbiamente è 
vero allo stesso tempo che inviare i dati già format- 
tati in una struttura HTML comporta un sovracca- 
rico della banda che oltre a trasportare i dati veico- 
la anche i tag HTML (<table>, <tr>, <td>, ecc.); ov- 
viamente resta da stabilire in che modo potremmo 
serializzare il DataSet per inviarlo alla nostra pagi- 
na. Tutte queste osservazioni servono solo a met- 



terci in guardia rispetto al modo in cui andiamo a 
sviluppare le nostre applicazioni; dobbiamo cerca- 
re giusto compromesso tra la gestibilità del codice, 
la sua scalabilità, la sua efficienza (sia in termini di tem- 
po di esecuzione che in termini di dati scambiati che 
influenzano il costo economico della soluzione), 
ecc.; in questo articolo si è scelto di demandare la 
formattazione dei dati al server, violando il disac- 
coppiamento dei livelli ma ottenendo molto meno co- 
dice da gestire e, sicuramente una maggiore velocità 
di esecuzione. 



CONCLUSIONI 

L'ultima moda nell'ambito dello sviluppo di ap- 
plicazioni web è sicuramente AJAX. Utilizzando 
diverse tecnologie come Javascript, il modello ad 
oggetti dei navigatori (Document Object Model - 
DOM) e l'XML, è oggi possibile ammirare nume- 
rosi siti (Google in testa a tutti) dove l'aggiorna- 
mento delle pagine non avviene più seguendo il 
classico paradigma del "post-back", dove l'intera 
pagina doveva essere ricaricata per aggiornare an- 
che solo una parte di essa, ma avviene in maniera 
parziale e solo le porzioni da aggiornare subisco- 
no effettivamente un cambiamento. Questo salto 
di qualità nella fruizione delle risorse web è coa- 
diuvato ancor più dalla nascita di numerosi stru- 
menti un grado di semplificare notevolmente lo 
sviluppo di siti basati su AJAX. Purtroppo questi 
strumenti si basano fortemente sulle caratteristi- 
che avanzate dei navigatori disponibili in ambiente 
desktop, caratteristiche che non trovano corri- 
spondenza nei "fratelli minori" disponibili nei di- 
spositivi mobili. Nel presente articolo si è mostra- 
to come in realtà sia possibile usufruire dei van- 
taggi offerti dalle soluzioni basate su AJAX anche 
in ambiente mobile. Il requisito minimo del no- 
stro navigatore mobile preferito è il supporto del- 
l'oggetto XmlHttpRequest che è alla base del col- 
loquio asincrono tra il nostro dispositivo e le ri- 
sorse web. Di seguito abbiamo costruito un pic- 
colo motore AJAX, costituito da tre funzioni scrit- 
te in Javascript, necessarie per gestire il colloquio 
tra una risorsa server ed il nostro navigatore. Il re- 
lativo aggiornamento delle informazioni è stato 
demandato ad una funzione, scritta a livello della 
pagina chiamante, che deve gestire i limiti talvol- 
ta imposti da navigatori mobili. 
Nell'ultima parte dell'articolo è stato illustrato un 
esempio in cui si è evidenziato il compromesso a 
cui è necessario sottostare quando si sviluppano so- 
luzioni per dispositivi mobili che hanno inevita- 
bilmente limiti e vincoli che in ambiente desktop 
non abbiamo. 
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MA QUANTE VISITE 
HA IL MIO SITO? 

IMPARIAMO A SFRUTTARE IL FORMATO DEI LOG DI MS IMPORTANDO I DATI IN UNA 
NOSTRA APPLICAZIONE E REALIZZANDO UN COMPLETO SISTEMA DI GESTIONE DELLE 
STATISTICHE. PER FARLO SFRUTTEREMO ANCHE SSIS... 




□ 



CD U WEB 

IIS_Logs.zip 



ffym 



è 



n 




REQUISITI 



Conoscenze richieste 



.— Microsoft.Net, T-SQL 



Visual Studio 2005, SQL 
Server 2005, SSIS 



00000 



A! 



bbiamo un sito web e vogliamo monitorarne 
gli accessi senza dover acquistare costosi 
.strumenti per le statistiche o affidarci a ser- 
vizi esterni. 

Perché non scriviamo noi un software per monitora- 
re il traffico del nostro sito? 

Utilizzando i log di US, Microsoft.Net, e SQL Server 
2005 realizzeremo un semplice sistema di statistiche 
degli accessi. 

Requisito per l'utilizzo del software che andremo a 
sviluppare è quello di avere l'accesso ai file di log tra- 
mite un percorso di rete oppure tramite ftp. 
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Figura 1: US Logs in azione! 



I LOG DI US 

US è dotato di un completo sistema per il log degli 
accessi. È possibile gestirlo tramite Internet 
Information Services Manager. Per aprire la 
maschera di configurazione, cliccare con il tasto 
destro del mouse sul nome del server e selezionare 
"Proprietà"; in basso spuntiamo flag "Consenti 
registrazione attività". È poi possibile scegliere il for- 
mato di log tramite la tendina "Formato registro atti- 
vo" e quali informazioni loggare cliccando su 
"Proprietà". 

Le informazioni che US riesce a loggare sono molte 
e sono suddivise in quattro categorie in base ad un 
prefisso: 

• s- : azioni server 

• e- : azioni client 



• cs- : azioni client-to-server 

• se- : azioni server-to-client 

Ecco, infine, alcune delle informazioni che è possi- 
bile ottenere: 




Figura 2: Configuriamo il tipo di log e le informazioni 
da salvare 



• date: la data dell'evento 

• time: l'ora 

• c-ip: Tip del client 

• cs-method: l'azione del client (GET, POST etc. . .) 

• cs-uri-stem: la risorsa richiesta 

• cs-uri-query: la querystring passata al server 

• se-status: lo stato HTTP dell'azione (es: 200 OK) 

• cs(User-Agent) : il browser del client 

• cs(Referer): il sito da cui si proviene 

I dati che US loggherà sono configurabili tramite la 
maschera "Proprietà registrazione estese". 
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Figura 3: lì nostro file di log 
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Per il nostro software decidiamo di memorizzare le 
informazioni contenute nella lista sopra descritta. 
Nella sezione "Proprietà generali" possiamo, invece, 
scegliere dove salvare nostro file di log. 
Gli accessi al sito saranno quindi monitorati e salva- 
ti in dei file come quello in figura. 



IL DATABASE 

Innanzitutto, creiamo il nostro database che con- 
terrà i log. 
Abbiamo bisogno di tre tabelle: 

• log_IISLogs: la principale, conterrà i log 

• sta_status_codes: conterrà i codici di stato 

• ext_extensions: per le estensioni dei file 

Ecco gli script per la creazione: 

— La tabella con i codici di stato 
CREATE TABLE [dbo].[sta_status_codes]( 

[sta_status] [varchar](10) COLLATE 

Latin l_General_CI_AS NOT NULL, 
[sta_description] [varchar](1000) COLLATE 

Latin l_General_CI_AS NULL, 
CONSTRAINT [PK_sta_status_codes] PRIMARY KEY 

CLUSTERED 

( 

[sta_status] ASC 
)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY] 
) ON [PRIMARY] 
GO 



— La tabella dei log 

CREATE TABLE [dbo].[log_HSLogs]( 

[logjd] [int] IDENTITY(1,1) NOT NULL, 
[log_datetime] [datetime] NULL, 
[log_client_ip] [varchar](15) COLLATE 

Latin l_General_CI_AS NULL, 
[log_method] [varchar](10) COLLATE 

Latin l_General_CI_AS NULL, 
[log_uri] [varchar](1000) COLLATE 

Latin l_General_CI_AS NULL, 
[log_uri_query] [varchar](1000) COLLATE 

Latin l_General_CI_AS NULL, 
[log_sta_status] [varchar](10) COLLATE 

Latin l_General_CI_AS NULL, 
[log_user_agent] [varchar](1000) COLLATE 

Latin l_General_CI_AS NULL, 
[log_referer] [varchar](1000) COLLATE 

Latin l_General_CI_AS NULL, 



CONSTRAINT [PKJogJISLogs] PRIMARY KEY 



CLUSTERED 



[logjd] ASC 



)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY] 



GO 



■ Aggiungiamo il constraint 



ALTER TABLE [dbo].[log_IISLogs] WITH CHECK ADD 

CONSTRAINT [FK_log_IISLogs_sta_status_codes] 
FOREIGN KEY([log_sta_status]) 
REFERENCES [dbo].[sta_status_codes] ([sta_status]) 



GO 



La tabella dei tipi di file 



CREATE TABLE [dbo].[ext_extensions]( 

[ext_extension] [varchar](4) COLLATE 

Latinl_General_CI_AS NOT NULL, 
[extjype] [varchar](3) COLLATE 

Latinl_General_CI_AS NOT NULL, 
CONSTRAINT [PK_ext_extensions] PRIMARY KEY 

CLUSTERED 



[ext_extension] ASC 



)WITH (IGNORE_DUP_KEY = OFF) ON [PRIMARY] 



) ON [PRIMARY] 



SYSTEM.NET 

Il namespace 
System. Net fornisce 
una serie di classi per 
la gestione dei 
protocolli di 
comunicazione. Tra 
quelle più utilizzate 
ricordiamo 
HttpWebRequest e 
HttpWebResponse per 
le richieste HTTP, o le 
nuove FtpWebRequest 
e FtpWebResponse per 
l'FTP. 

Ulteriori informazioni 
sono disponibili 
all'indirizzo: 
http://msdn2.microsoft.co 
m/it- 

it/librarv/svstem,net(VS,8 
OO.aspx 



GO 



log_IISLogs 



Nome colonna 

logjd 

log_datetime 

log_dient_ip 

log_method 

log_uri 

log_uri_query 

log_sta_status 

log_user_ag... 

log_referer 



Tipo abbreviato 

int 

datetime 

varchar(15) 

varchar(lO) 

varchar(lOOO) 

varchar(lOOO) 

varchar(lO) 

varchar(lOOO) 

varchar(lOOO) 



ext extensions 



? ext_extension 
ext_type 






sta_status_codes 


Nome colonna Tipo abbreviato 


S 


sta_status varchar(lO) 


sta_descript ... varchar( 1 000) 









) ON [PRIMARY] 



Figura 4: Il database dei log 



L'ARCHITETTURA 

Il nostro software sarà formato da tre componenti: 

• un client ftp: per effettuare il download del file 
di log 

• un package di SSIS: per impostare i dati in SQL 
Server 

• una web application: per visualizzare i dati 

Un package SSIS schedulato giornalmente si occu- 
perà di lanciare il client FTP per recuperare il file di 
log e, una volta scaricato tale file, di elaborarlo ed 
importarlo nella tabella di SQL Server. 
La web application avrà il compito di visualizzare i 
dati relativi ad accessi, pagine viste, referals ed altro. 



http://www.ioprogrammo.it 



Maggio 2007/ 43 ► 



042-049 30-03-2007 15:29 Pagina 44 



ioProgrammo Web T I Un'applicazione per il monitoring degli accessi 





IL CODICE 
ALLEGATO 

Gli esempi 

nell'articolo sono in 

Visual Basic; per chi 

fosse interessato, nel 

CD allegato è presente 

tutto il codice 

sorgente anche in C#. 



IL CLIENT FTP 

Iniziamo con la scrittura del client FTE 
Per la realizzazione della classe per l'FTP utilizzere- 
mo il namespace System.Net che contiene due clas- 
si FtpWebRequest e FtpWebResponse le quali con- 
sentono di effettuare richieste FTP e leggere le rela- 
tive risposte. Apriamo Visual Studio e creiamo un 
nuovo progetto di tipo "Console" chiamato 
IISLogFTPDownloadVB; creiamo quindi la classe 
FTPClient.vb che gestirà l'FTR 
All'interno della classe dichiariamo delle proprietà 
private: 



Private _Protocol As String ' Il protocollo usato 


Private _Host As String ' L'host 


Private _FilePath As String ' Il persorso del file 


Private _User As String ' Nome utente 


Private _Pass As String ' Password 


Private _SSL As Boolean ' Se collegarsi con SSL 


Private _Passive As Boolean ' Se usare la modalità 

passiva 


Private _Conn As FtpWebRequest ' La richiesta FTP 


Private _Resp As FtpWebResponse ' La risposta FTP 

e quindi il costruttore: 

Public Sub New(ByVal Protocol As String, ByVal Host 
As String, ByVal User As String, ByVal Pass As String, 
ByVal SSL As Boolean, ByVal Passive As Boolean) 




_Protocol = Protocol 


_Host = Host 


_FilePath = "" 


_User = User 


_Pass = Pass 


_SSL = SSL 


_Passive = Passive 




End Sub 



che valorizza alcune delle proprietà della classe. 



Public Function Download(ByVal FilePath As String, 

ByVal FileDestination As String) As Integer 



Try 



_FilePath = FilePath 



Connessione all'host ftp 



ConnectQ 



Imposto il tipo di richiesta 



_Conn.Method = 

WebRequestMethods.Ftp.DownloadFile 

' Ottengo la risposta e la inserisco in uno 

stream 
_Resp = CType(_Conn.GetResponse(), 

FtpWebResponse) 
Dim _RespStream As Stream = 

_Resp.GetResponseStream() 

' Salvo lo stream in un file leggendolo a blocchi 

di byte 
Dim _File As FileStream = New 

FileStream(FileDestination, FileMode. Create, 
FileAccess.Write) 

Try 

Dim buf(1024) As Byte 
Dim bytesRead As Integer = 

_RespStream.Read(buf, 0, buf.Length) 
While (bytesRead <> 0) 

_File.Write(buf, 0, bytesRead) 
bytesRead = _RespStream.Read(buf, 0, 

buf.Length) 
End While 

Return 

Finally 

_File.Close() 
_RespStream.Close() 



IL METODO COIUIUECT 


Private Sut 


Connect() 




_Conn 


= CType(WebRequest.Create(_Protocol & 
"://" & _Host & _FilePath), FtpWebRequest) 


_Conn 


EnableSsI = 


_SSL 


_Conn 


UsePassive 


= _Passive 


_Conn 


Credentials 


= New 
NetworkCredential(_User, _Pass) 


End Sub 



crea una WebRequest alla risorsa, la "casta" come 
FtpWebRequest ed imposta i parametri di connes- 
sione. 
Cuore della classe è, infine, la funzione Download: 



End Try 



Catch ex As WebException 



If (ex.Message.Contains("550")) Then 



Return 550 ' File non trovato 



Elself (ex.Message.Contains("530")) Then 



Return 530 'Accesso negato 



Elself (ex.Message.Contains(_Host)) Then 

'Host non trovato 



Return 551 



Else 



Return -2 ' Errore generico 



End If 



Catch e As DirectoryNotFoundException 
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Return 


-500 






Catch 


Return 


-2 


Errore 


generico 


End Try 




End Function 



Vediamo come lavora: 

legge, come prima cosa, il percorso del file da scari- 
care e lo salva nella proprietà privata _FilePath, 
quindi, lancia il metodo ConnectO per collegarsi al 
server FTP 
Tramite la riga 



<add key="ErrorsFile" 






value="C:\IISLogs\ERR.txt"/> 



</appSettings> 



</configuration> 

Per utilizzare il download da percorso di rete, occor- 
re cambiare due righe del web.confìg 

<add key="Protocol" value="share"/> 
<add key="BaseFilePath" 

value="\\NomeShare\NomeCartella\"/> 

Vediamo infine il Main del programma: 



j'0 : 0! ; ;ì; ;n 
[Hi li Sjìll il 
il;' j!j il 



WWf 



_Conn.Method 



Sub Main() 



WebRequestMethods.Ftp.DownloadFile 



viene impostato il metodo della WebRequest a 
"DownloadFile". 

Dopo aver effettuato la connessione, leggiamo la 
risposta tramite il metodo GetResponseO della clas- 
se FtpWebRequest e da questa otteniamo uno 
Stream di dati utilizzando il metodo GetResponse 
StreamO 



_Resp = CType(_Conn. GetResponseO, 



FtpWebResponse) 



Dim _RespStream As Stream = 

_Resp.GetResponseStream() 

Ottenuto lo stream di dati, il più è fatto: è sufficiente 
salvarlo su file. Per farlo, utilizziamo un ciclo che 
legge i dati dallo stream a blocchi di byte e li salva in 
un FileStream. 

La funzione restituisce un valore intero. Il valore 
restituito sarà zero se il download va a buon fine, 
altrimenti viene restituito un codice di errore in base 
al tipo di eccezione che si è verificata. La funzione 
GetErrorMessage converte il codice di errore in un 
messaggio "user friendly". 

Realizzata la classe per l'FTP, occupiamoci del pro- 
gramma. Aggiungiamo un file di configurazione 
app.config al progetto. Vi memorizzeremo le infor- 
mazioni per l'accesso FTP 

<?xml version="1.0" encoding="utf-8" ?> 
<configuration> 
<appSettings> 
<add key="Protocol" value="ftp"/> 
<add key="Host" value="ftp.nomeserver.it"/> 
<add key="BaseFilePath" 

value="/cartellainiziale/cartellalogs/"/> 
<add key="User" value="username"/> 
<add key="Pass" value="password"/> 
<add key="SSL" value="false"/> 
<add key="Passive" value="true"/> 
<add key="FileDestination" 

value="C:\IISLogs\IISLog.txt"/> 



'Variabili da configurazione 



Dim Protocol As String = 

ConfigurationManager.AppSettings("Protocol") 
Dim Host As String = 

ConfigurationManager.AppSettings("Host") 
Dim BaseFilePath As String = 

ConfigurationManager.AppSettings("BaseFilePath") 
Dim User As String = 

ConfigurationManager.AppSettings("User") 
Dim Pass As String = 

ConfigurationManager.AppSettings("Pass") 
Dim SSL As String = 
Convert.ToBoolean(ConfigurationManager.AppSettings 

("SSL")) 

Dim Passive As String = 
Convert.ToBoolean(ConfigurationManager.AppSettings 

("Passive")) 
Dim FileDestination As String = 
ConfigurationManager.AppSettings("FileDestination") 
Dim ErrorsFile As String = 

ConfigurationManager.AppSettings("ErrorsFile") 

'Nome del file da scaricare 

Dim day As DateTime = DateTime.Now.AddDays(- 



1) 



Dim Alenarne As String = "ex" & 

day.ToString("yyMMdd") & ".log" 



Scarico il file 



If Protocol = "ftp" Then 



Dim ftp As FTPCIient = New FTPCIient(Protocol, 

Host, User, Pass, SSL, Passive) 
Dim i As Integer = ftp.Download(BaseFilePath 

+ Alenarne, FileDestination) 

'Se ho un errore, cancello il file e inserisco un 

log di errore 



If (i <> 0) Then 



File.Delete(FileDestination) 



Dim sw As StreamWriter 
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File.AppendText(ErrorsFile) 



Try 



sw.writeLine(DateTime.Now & " " & 

FTPCIient.GetErrorMessage(i)) 



Finally 



sw.Close() 



End Try 



End If 



Elself Protocol = "share" Then 



Dim f As Filelnfo = New FileInfo(BaseFilePath 

& filename) 



If (f.Exists) Then 



f.CopyTo(FileDestination,True) 



Else 



File.Delete(FileDestination) 



End If 



End If 



End Sub 

In sequenza: 

• vengono lette le variabili dall' app.config 

• viene generato il nome del file da scaricare in for- 
mato standard 

• se il metodo è ftp, viene istanziata la classe 
FTPClient e richiamato il metodo Download 

• se il metodo è share, il file è prelevato dal percor- 
so di rete 

Eseguendo il programma, il file dei log del giorno 
precedente alla data di esecuzione verrà scaricato 
nella cartella di destinazione. 



IMPORTIAMO I DATI! 

Occupiamoci adesso di importare i dati nelle tabelle 

di SQL Server utilizzando un pacchetto SSIS (SQL 

Server Integration Services). 

Apriamo Visual Studio e creiamo un nuovo progetto 

di tipo "Business Intelligence" chiamato 

IISLoglmport. 



Come prima cosa, inseriamo un "Execute Process 
Task", chiamiamolo "FTP Download" ed associamo 
ad esso l'esecuzione del programma che effettua il 
download del file di log. Creiamo sul disco C una 
cartella chiamata C:\IISLogs e copiamo in essa l'e- 
seguibile ottenuto dalla compilazione del preceden- 
te progetto. Configuriamo quindi il task: clickiamo 
sull'icona con il tasto destro del mouse e quindi su 
"Edit". Nel tab "Process" scriviamo "C:\IISLogs\ 
IISLogFTP Download.exe" in corrispondenza della 
voce "Executable". Aggiungiamo quindi un "Data 
Flow Task" che chiameremo "Import Task". 
Facciamo doppio clic sull'icona del Data Flow Task. 
Così facendo passiamo nella parte di definizione del 
DataFlow. Introduciamo innanzitutto la sorgente 
dati, ovvero il file che abbiamo scaricato in 
"C:\IISLogs\ IISLog.txt".Inseriamo nel Data Flow 
una "Fiat File Source", clicchiamo sopra l'icona con il 
tasto destro del mouse e selezioniamo "Edit". Nella 
sezione "Connection Manager" clicchiamo su 
"New..." per collegarci alla sorgente dati. Nella 



*n 



FTP Download 



W 



ImportTask 



Figura 6: La prima parte del package 



maschera di creazione della sorgente dati, diamo un 
nome alla sorgente e selezioniamo il file IISLog.txt. 
Spostiamoci quindi nella sezione "Columns" ed 
inseriamo "{CR}|LF}" come delimitatore di riga ed 




Description: 



tgt General 
9 Columns 
HI Advanced 
__ Preview 



Configura the propertias of eaeh eolumn, 



og_date 
og_time 
oci_.".ii*nf jp 

og_uri 

og_uri_query 

og_5ta_sr.ar.u5 



_ 



i-olurrinType ■ Qehmited 

Output ColumnWid 1000 
ColumnDelimiter [CR>-(LF> 
TextQualified True 

D_t_Type string [DT_5TR] 

Narne log_rer_r_r 

D-taPrec-lon . D 

Input "olumnWidtH D 



Figura 5: Creiamo ii package SSiS 



Figura 7: Le coionne del file sorgente 
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_L_ 




•»W 



Figura 8: Deriviamo la colonna data-ora 







D"* 



ML 5*™ l O fltf 1 , S— «*« PttkHt 



53lA0*5(ft***W 









Figura 11: Scheduliamo l'esecuzione del package 




uno spazio come delimitatore di colonna; questo 
perché nei file di log di US le colonne sono delimita- 
te per l'appunto da un carattere blank. Nella sezione 
"Advanced" impostiamo i nomi delle colonne, i tipi 
di dato e le dimensioni. 
Il file di log di US contiene due campi separati per la 



DB 



— 



COnfara thè prqperMf i4ed to tts&t dati rto a '«laCcrnl database us*fl ai OLL Ce UrOMtòéi 



ln^ 



l«LCit«_Ìfr 

IO(UHÌ,àJHV 

Ina r*f*ei 



^_-2 



2 



"WWW 



*ia_.j-.«_A3 



Figura 9: Mappiamo i campi del file di testo con 
le colonne della tabella 



data e per l'ora; nella nostra tabella di SQL Server 
abbiamo un solo campo "data-ora", aggiungiamo 
quindi un task che ci permetta di derivare la colon- 
na data-ora a partire dalle due colonne separate. 
Il task in questione è il "Derived Column". 
Inseriamolo nel Data Flow. Al solito, clicchiamo 
sopra l'icona con il tasto destro del mouse e quindi 
su "Edit" per configurarlo. Aggiungiamo una nuova 
colonna derivata: "log_datetime" e come espressio- 
ne inseriamo seguente codice: 

log_date + " " + log_time 



^rf Log File 






' 


■ 


=|*t= Log DateTirne 






1 


r 


SJ Log Import 



Figura IO: Gli oggetti 
del Data Flow 



A questo punto non ci resta 
che configurare la destina- 
zione dei dati. Inseriamo 
una "OLE DB Destination" 
e configuriamola. 
Nella sezione "Connection 
Manager", selezioniamo il 
database e quindi la tabella 
di destinazione dei dati. 
Nella sezione "Mappings" 
configuriamo le corrispon- 
denze tra le colonne del file 



sorgente e quelle della tabella di destinazione. A 
questo punto il package è pronto, non ci resta che 
importarlo in SQL Server. Innanzitutto, creiamo l'u- 
nità di Deploy. Clickiamo con il tasto destro del 
mouse sul nome della solution e selezioniamo 
"Properties". Impostiamo a True il valore del para- 
metro "CreateDeploymentUtility" e compiliamo il 
progetto. Andiamo nella directory "Bin" in cui trove- 
remo il file "IISLoglmport.dtsx". Copiamo il file 
"C:\IISLogsDeploy", apriamo una commad prompt 
ed eseguiamo: 

dtutil /FILE " C:\ IISLogsDeploy \ IISLoglmport.dtsx" 

/DestServer Nome_Server /COPY SQL; IISLoglmport 

Non ci resta che schedulare l'esecuzione del packa- 
ge. Apriamo "SQL Server Management Studio", col- 
leghiamoci al server ed espandiamo il menu "SQL 
Server Agent". Clicchiamo con il tasto destro del 
mouse su "Jobs" e clicchiamo su "New job..." 
Diamo un nome al package. Nella sezione "Steps" 
aggiungiamo lo step che permette di eseguire il 
package. Come "Type" scegliamo "SQL Server 
Integration Services Package", scegliamo quindi il 
package che abbiamo appena importato in SQL 



Table-dbo.log IISLogs CRJ',SC'L20C5.i,..QLOue!7l-5i.l :ii Surnmary 




logjd 


log_datetime logjdieritJP 1*3 niethod log_uri logjjri_qijery log_sta_statJ5 


logjjssr 


10/02/2007 16. +3. 24 127.0.0 




GET jiisogderno/chisianio.htm 


401 


Mez la/4 


249 
250 
251 


10/02/2007 16,43,24 127,0,0 
10/02/200 7 16.43.24 127.0.0 




GET ji e ogderno/chi 5 ianio , htni 


304 


■ 


GET /ii£agderno/lriirnagine_02.png 


304 


10/02/2007 16,43,26 127,0,0 




■SET /iisogderno/default.htni 


304 


252 


10/02/2007 16.43.26 127.0.0 




GET Jii5ogd&rno/tmrnagìne_01.png 


304 


10/02/2007 16.43.26 127.0.0 




GET iNsogde.no/dove. htm 


304 


25+ 


10/02/2007 16.43,26 127.0.0 
10/02/2007 16.43.27 127.0.0 




GET /iisogderno/Imrnagine 04,png 


304 


B " * 


GET Jiisogderno/coniaiti.hirn 


304 


256 


10/02/2007 16,43,27 127,0,0 




<_ET li .'Vii ! 


304 


«... m 


257 
258 
259 


10/02/2007 16.43.34 127.0.0 




GET /i is ogderno/contatti . h trn 


200 


10/02/2007 16,43,34 127,0,0 




.■■.:■■.■.... ■■■■ ■■.■■ 


200 


Mi: hi- 


Ir. 4--.4S 127.0.0 




GET /iisagderno/default.litrii 


401 


260 


10/02/2007 16.43. 59 127.0.0 




GET /iisogderno 


401 


2É1 


10/02/2007 16.43,59 127.0,0 




GET /iisogderno/ 


302 


"" '"' 


10/02/2007 16.43.59 127.0.0 




GEI 


304 


263 

264 
265 
266 


10/02/2007 16,43,59 127,0,0 
10/02/2007 16.44.01 127.0.0 




'.,'E ' ■: i .■.■■: • iti 

GET /iisogderno/defaolt.litrii 


304 


. ■: m 


304 


10/02/2007 16,44,01 127,0,0 




GET /i is ogderno/chi ; ianio , htm 


304 


10/02/2007 16.44.01 127.0.0 




GET /iisogderno/Imrnagìne_02.png 


304 


'' ""' 




304 



Figura 12: 1 dati su SQL Server! 



Server.Passiamo quindi alla sezione "Schedules" per 
configurare l'esecuzione giornaliera del package. 
Inseriamo "Daily" come frequenza e l'una di notte 
come orario per l'esecuzione. 



CODICI 
DI STATO 

Quando viene 
effettuata una 
richiesta ad un web 
server, questo, oltre a 
fornire la 

risposta.restituisce dei 
codici di stato che 
indicano che esito ha 
avuto la richiesta. 



Sono raggruppati nel 
seguente modo: 

1xx- Messaggi 

informativi 

2xx - Esito positivo 

3xx - Reindirizzamento 

4xx - Errore del client 

5xx - Errore del server 

La lista completa con 
le descrizioni è 
presente nella tabella 
"sta status codes" del 
database contenuto 
nel CD allegato 
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~ L'AUTORE 



E un ingegnere 

informatico. 

Si occupa di sviluppo 

software in ambiente 

.Net per una società di 

informatica di Milano. 

Gestisce un sito ricco 

di script e manuali per 

chi si affaccia al 

mondo della 

programmazione web 

( www.morpheusweb.it) . 



Salviamo la schedulazione. Per provare l'importa- 
zione, clicchiamo con il tasto destro del mouse sul 
nome del job che abbiamo salvato e selezioniamo 
"Start Job". Se tutto è andato a buon fine, dovremmo 
trovare i dati nella nostra tabella. 



VISUALIZZIAMO I DATI 

A questo punto i dati sono su SQL Server, "non ci 
resta che" preparare un'applicazione web per visua- 
lizzarli... Creiamo un progetto web chiamato 
"IISLogViewerVB" ed aggiungiamo il web.config 
contente la stringa di connessione al database ed 
una "MasterPage" che farà da template per la nostra 
applicazione. Il codice della master page è presente 
nel CD allegato. 
La pagina ha tre componenti principali: 

• una TreeView per i link alle funzioni 

• un ContentPlaceHolder per la lista dei dati 

• un ContentPlaceHolder per i grafici 

Una volta creata la MasterPage, occorre realizzare le 
pagine dei report. Prima di procedere alla realizza- 
zione delle pagine, creiamo una classe "Utils.vb" che 
conterrà i metodi per popolare il GridView dei dati e 
generare grafico relativo. 
La classe contiene due funzioni Shared: 



US STAI 




Figura 13: 1 dati su SQL Server! 



• LoadGrid: per caricare la griglia 

• LoadGraph: per generare il grafico 

Analizziamole una alla volta. 

Public Shared Function LoadGrid(ByVal SQL As String, 

ByVal grd_dati As GridView) As DataSet 

Dim Result As DataSet = New DataSetQ 

Dim conn As SqlConnection = New 
SqlConnection(ConfigurationManager.ConnectionStrin 
gs("ConnectionString").ConnectionString) 
Try 

conn.OpenQ 

Dim Command As SqlCommand = New 

SqlCommand(SQL, conn) 



Dim da As SqlDataAdapter = New 

SqlDataAdapter( Command) 

da.Fill(Result) 
grd_dati.DataSource = 



Result.Tables(0).DefaultView 



grd_dati.DataBind() 



Finally 



conn.CloseQ 



End Try 



Return Result 



End Function 

La funzione popola un GridView (passato come 

parametro) a partire da una query e restituisce un 

DataSet. 

Vediamo adesso la procedura per caricare il grafico: 

Public Shared Sub LoadGraph(ByVal Result As 

DataSet, ByVal ImagePath As String, ByVal FileName 

As String, ByVal SessionlD As String, ByVal 

img_graph As System. Web. Ul.WebControls.Image) 

Dim max As Doublé = 



Dim Values(Result.Tables(0).Rows.Count) As 



Integer 



For i As Integer = To 

Result.Tables(0).Rows.Count - 1 
Values(i) = 
Convert.ToInt32(Result.Tables(0).Rows(i).ItemArray 

(3)) 



IfValues(i) > max Then 



max = Values(i) 



End If 



Next 



Dim spaces As Integer = 35 



Dim scale As Doublé = (100 / max) 



Dim intMax As Integer = 100 



Dim intScale As Integer = 

Convert.ToInt32(Math.Floor(scale)) 

Dim bm As Bitmap = New Bitmap(400, intMax) 



Dim g As Graphics 



g = Graphics. Fromlmage(bm) 



g.Clear(Color.White) 



For i As Integer = To Values.Length - 1 



g.FillRectangle(New SolidBrush( . 



Color.FromArgb(113, 248, 110)), _ 



(i * spaces) + 15, _ 



intMax - Convert.ToInt32((Values(i) 



scale)), _ 
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20, 



Convert.ToInt32((Values(i) * scale)) + 5) 



g.DrawRectangle( _ 



Pens. Black, 



(i * spaces) + 15, _ 



Convert.ToInt32(intMax - (Values(i) 



scale)), _ 



20, (_ 



Convert.ToInt32(Values(i) * scale)) + 5) 



Next 



bm.Save(ImagePath + "\\" + FileName + 

SessionlD + ".jpg", ImageFormat.Jpeg) 
img_graph.ImageUrl = "~\\graph\\" + FilelMame 

+ SessionlD + ".jpg" 
End Sub 

Utilizziamo il DataSet restituito dalla funzione 
LoadGrid per leggere i valori trovati con la query ed 
inserirli in un'array. Con: 

Dim bm As Bitmap = New Bitmap(400, intMax) 

creiamo una bitmap di dimensioni 400x100 che fun- 
gerà da "placeholder" per il nostro grafico. Cicliamo 
quindi l'array dei valori e, per ciascun elemento, 
disegniamo un rettangolo le cui dimensioni sono 
proporzionate rispetto al massimo valore trovato. 
Salviamo infine l'immagine e la associamola all'og- 
getto "img_graph" che sarà presente nella pagina 
aspx. Una volta create le funzioni base, passiamo 
alla realizzazione dei report. Prepariamo la 
WebForm delle pagine viste. Aggiungiamo una pagi- 
na che eredita dalla MasterPage e chiamiamola 
"PagineViste.aspx". Nei ContentPlaceHolder aggiun- 
giamo un GridView e, in basso, un componente 
Image per il grafico. Analizziamo quindi la query per 
recuperare i dati. Prima, però, occorre ricordare che 
US logga l'accesso a qualsiasi risorsa; quindi, nei log 
troveremo, oltre alle righe relative alle pagine, anche 
le richieste relative ad immagini, icone ed altri tipi di 
file. In un report delle pagine viste siamo interessati 
ad un determinato tipo di risorsa (html, asp, aspx 
ect...). Per poter filtrare le tipologie di documenti 
che ci interessano, abbiamo in precedenza creato la 
tabella ext_extensions, che contiene l'estensione del 
file e il tipo di documento relativo su cui poter fare 
dei filtri. 

SELECT 
YEAR(log_datetime) AS Anno, MONTH(log_datetime) 

AS Mese, DAY(log_datetime) AS Giorno, 
COUNT(*) 
FROM 

( 

SELECT *, SUBSTRING( 

log_uri, CHARINDEX('.',log_uri, LEN(log_uri)- 5)+l, 
LEN(log_uri)-CHARINDEX('.',log_uri, LEI\l(log_uri)-5) 
) AS Extension 



FROM logJISLogs (NOLOCK) 



) AS IISLogs 



INNER JOIN ext_extensions 



ON ext_extension = IISLogs. Extension 



WHERE extjype = 'PAG' GROUP BY 



YEAR(log_datetime), MONTH(log_datetime), 

DAY(log_datetime) 



ORDER BY 



YEAR(log_datetime), MONTH(log_datetime), 

DAY(log_datetime) 

Abbiamo una sub-query che estrae l'estensione 
della risorsa che è stata richiesta. Mettiamo il risul- 
tato della query in join con la tabella delle estensio- 
ni e recuperiamo esclusivamente le righe il cui tipo è 
stato codificato come "PAG", ovvero pagina. 

Protected Sub Page_Load(ByVal sender As Object, 

ByVal e As System. EventArgs) Handles Me.Load 
Try 



Dim SQL As String 



SELECT" & 



" YEAR(log_datetime) AS Anno, 
MONTH(log_datetime) AS Mese, DAY(log_datetime) 

AS Giorno," & 



" COUNT(*)" &" FROM" a_ 



" (" & _" SELECT" & _ 



SUBSTRINGf &_ 



log_uri, CHARINDEX('.',log_uri, 

LEN(log_uri)-5)+l, 



& 



LEN(log_uri)-CHARINDEX('.',log_uri, 

LEN(logjri)-5)" &_ 



) AS Extension " & _ 



FROM logJISLogs (NOLOCK)" & _ 



" ) AS IISLogs" & _ 



" INNER JOIN ext_extensions" & 



" ON ext_extension = IISLogs. Extension 
" WHERE extjype = 'PAG'" & _ 



" GROUP BY ' 



" YEAR(log_datetime), 
MONTH(log_datetime), DAY(log_datetime)" &_ 
" ORDER BY" & " YEAR(log_datetime), 
MONTH(log_datetime), DAY(log_datetime)" 
Dim Result As DataSet = Utils.LoadGrid(SQL, 

grd_dati) 
Utils.LoadGraph(Result, 
Server.MapPath("graph"), "visite", Session. SessionlD, 

img_graph) 
Catch 

'gestione errori 
End Try 
End Sub 



A questo punto il gioco è fatto, non ci resta che inse- 
rire la query nella pagina e richiamare i due metodi 
per riempire la griglia e disegnare il grafico, eseguire 
il progetto e goderci le nostre statistiche in tutto il 
loro splendore! 

Carmelo Scuderì 
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UNA SOLUZIONE AJAX 
PER IL DRAG & DROP 

IMPAREREMO COME CREARE UN CARRELLO DELLA SPESA CHE ACCETTA I PRODOTTI 
SEMPLICEMENTE PER TRASCINAMENTO. PER IMPLEMENTARE IL TUTTO SARÀ SUFFICIENTE 
QUALCHE RIGA DI JAVASCRIPT E UN PO' DI HTML AVANZATO 



In questo articolo creeremo una web applica- 
tion dotata di un carrello della spesa dove 
potremo inserire i prodotti semplicemente 
trascinandoli dalla loro posizione iniziale. 
Al termine dell'operazione di trascinamento, 
verrà effettuata una chiamata asincrona al ser- 
ver, comunicandogli l'avvenuto acquisto del pro- 
dotto, con conseguente aggiornamento del data- 
base. 

Faremo tutto questo utilizzando Ajax e 
Javascript. L'accoppiata ci consentirà di non 
effettuare mai alcun reload della pagina, ed uti- 
lizzare l'applicazione web come faremmo nor- 
malmente con un'applicazione dekstop. 
L'utilizzo di Ajax, per coloro che non conoscesse- 
ro ancora questa tecnica di progettazione web- 
based, ci permette di interagire con il server in 
qualsiasi momento senza dover per forza "ricari- 
care" la pagina corrente: il server, non appena 
ricevuta la richiesta via POST o GET, restituirà al 
client il risultato di un'elaborazione (nel nostro 
caso, l'aggiornamento del DB). Questo risultato 
verrà processato da una funzione Javascript chia- 
mata in modo asincrono, che aggiornerà il conte- 
nuto del DIV "carrello" utilizzando le funzionalità 
del DOM (Document Object Model). 
È evidente che l'utilizzo di Ajax ci agevola moltis- 
simo, visto che possiamo lavorare direttamente 
nella nostra pagina web "vecchia", che viene di 
volta in volta aggiornata dalle transazioni che 
effettuiamo con il server in modo asincrono e 
trasparente. 

A questo punto occorre fare, tuttavia, una preci- 
sazione: le funzionalità di drag & drop, anche 
abbinate ad Ajax, fanno già parte, spesso, di molti 
framework, i quali consentono, peraltro, di inte- 
grare le stesse con effetti speciali, animazioni, e 
così via, in modo estremamente semplice ed 
intuitivo. Va rimarcato, peraltro, che l'utilizzo 
diretto di Ajax e Javascript senza l'utilizzo di fra- 
mework specializzati è una scelta da valutarsi 
attentamente, a seconda della grandezza e com- 
plessità dell'applicazione da realizzare. 



& 



LLi^li 



Sul CD allegato alla rivista è disponibile il co- 
dice sorgente del presente articolo, diviso in 
due cartelle. Per eseguire il carrello occorre 
disporre di un'installazione PHP - MySql, e di 
un web-server. Andrà quindi creato un DB ed 
eseguito il file SQL allegato, quindi biso- 
gnerà copiare la cartella all'interno del web- 
server. Per eseguire il gioco, allo stesso mo- 
do, occorre copiare la cartella relativa all'in- 
terno del web-server. 



J 



Detto questo, bisogna comunque considerare 
che non sempre le nostre esigenze si adattano 
perfettamente alle funzionalità offerte da un fra- 
mework, mentre spesso conviene molto di più 
scrivere noi direttamente il codice che ci interes- 
sa, per risparmiare una grande quantità di spazio 
e raggiungere effettivamente l'obiettivo deside- 
rato. 

Nel nostro esempio, infatti, vogliamo sì dotare di 
funzionalità drag & drop la nostra applicazione, 
ma vogliamo nello stesso tempo ottenere che il 
trascinamento non coinvolga direttamente il 
prodotto su cui abbiamo cliccato, ma una sua 
copia generata dinamicamente sul momento. 
Ecco, quindi, che nel caso in questione, evidente- 
mente, ci troviamo di fronte ad una richiesta 
molto particolare, che mal si adatta ad essere 
risolta con un framework, per versatile e comple- 
to che sia. 

In questi casi, peraltro, ci viene incontro il già 
nominato DOM, che rappresenta un modello di 
definizione del codice XHTML basato su una 
struttura ad albero, in cui ogni nodo corrisponde 
ad un elemento della pagina web. La struttura a 
nodi permette, quindi, di inserire i singoli ele- 
menti all'interno di una vera e propria gerarchia 
basata sull'oggetto Document, ovvero il "conte- 
nitore" principale della pagina web, identificato 
dal tag HTML. 

Tramite il DOM, in particolare, possiamo refe- 
renziare elementi esistenti o generarne di nuovi, 




n 




REQUISITI 



Conoscenze richieste 



Li 



Discreta conoscenza di 
Javascript, basi di Ajax, 
elementi di PHP e 
MySql 

. PHP, Mysql, un web- 
f server, un qualunque 
"^ browser aggiornato 




http://www.ioprogrammo.it 



Maggio 2007/ 53 ► 



053-055 28-03-2007 14:51 Pagina 54 



ioProgrammo Web T B Approfondimenti sui web 2.0 




semplicemente utilizzando metodi standard, 
validi per qualsiasi browser. 
La seguente porzione di codice crea degli ele- 
menti XHTML e li "appende" ad un DIV: 

var trascina =document.getElementById("trascina"); 
immagine = document.createElement("img"); 
immagine. src= "immagine, png"; 
immagine. style.cursor="move"; 

br=document.createElement("br"); 

testo=document.createTextNode("testo"); 



trascina. innerHTML= 



//svuoto il DIV 



preventivamente, usando il metodo innerHTML 
trascina. appendChild(immagine); //comincio ad 

appendere i singoli elementi al DIV 



Come si può vedere, il DOM consente un 
approccio al documento Web decisamente 
modulare, risparmiando allo sviluppatore parec- 
chi grattacapi; per contro, la sintassi dei vari 
comandi è fatta in modo tale da generare righe 
di codice molto lunghe, che necessitano di parti- 
colare attenzione per essere interpretate corret- 
tamente. 

Il funzionamento dell'applicazione può essere 
suddiviso nelle seguenti fasi: 

1 innanzitutto, il server tramite PHP genera il 
contenuto della tabella contenente i prodotti 
da acquistare. Ho usato una tabella per impagi- 
nare con semplicità i prodotti, ma potevo usare 
qualsiasi altro contenitore (un DIV un fieldset, o 
meglio ancora una lista (UL)). 
Nell'esempio, tuttavia, mi sono limitato a creare 
staticamente il codice HTML della tabella, anche 
se è evidente che in un caso reale ciò dovrebbe 




IL WEB E LA TRASPARENZA 



Il Drag & Drop si presta moltissimo ad essere arricchito con effetti 
grafici particolarmente accattivanti: uno di questi è sicuramente la 
trasparenza. Il formato delle immagini che più si presta a questo tipo 
di utilizzo è sicuramente il PNG (Portable Network Graphics), nato nel 
1995 come alternativa al GIF, che all'epoca era coperto da brevetto. Il 
PNG, in particolare, ha caratteristiche molto migliori del GIF, che van- 
no da un miglior rapporto di compressione, al supporto della traspa- 
renza variabile e di una gamma di colori molto più ricca. Di contro, In- 
ternet Explorer fino alla versione 6 non supporta correttamente la 
trasparenza con il PNG, aggiungendo alle immagini uno sfondo gri- 
gio. Per ovviare a questi inconvenienti Microsoft ha messo a disposi- 
zione diversi strumenti, tra cui filtri proprietari, behaviours (comporta- 
menti particolari associati a determinate regole CSS, che nel caso in 
questione si basano su un file .htc e una gif trasparente che devono 
essere inseriti nella cartella dell'applicazione), ecc.. 



essere effettuato proprio dal server (d'altra 
parte, la pagina ha già estensione PHP quindi il 
lettore che desidera aggiungere codice lato ser- 
ver alla pagina può farlo agevolmente !). 

2 le immagini dei prodotti hanno poi, sull'e- 
vento onmousedown, agganciata una funzio- 
ne che riempie il DIV "trascina" con il contenuto 
del prodotto e lo rende visibile (il valore della 
proprietà Display, infatti, inizialmente è settato a 
"none"). Quest'ultimo DIV, peraltro, segue il 
mouse in ogni suo movimento, almeno finché 
non viene rilasciato il pulsante per terminare il 
trascinamento (quando, cioè, su onmouseup, 
l'oggetto globale che rappresenta il DIV viene 
deallocato e il DIV viene reso nuovamente invisi- 
bile). 

3 Terminato il trascinamento, su rilascio del 
pulsante del mouse, viene eseguito un con- 
trollo per verificare se l'oggetto da noi trascinato 
si trova ora localizzato all'interno del DIV "car- 
rello". In tal caso, viene contattato tramite Ajax il 
server, che aggiorna il DB, e restituisce il totale 
dei nostri acquisti. Se anche questa funzione va 
correttamente in porto, allora viene creata una 
nuova lista UL riferita al prodotto in questione 
(sempreché questa già non esista) e viene 
aggiunto un numero di elementi LI ("list-item") 
pari al contenuto numerico della casella di testo 
del DIV "trascina". Se la lista già esiste, invece, 
allora la funzione semplicemente "appende" i 
prodotti ad essa. 



GESTIAMO IL TAG DIV 

La posizione del DIV "trascina", come già anti- 
cipato più sopra, è vincolata al puntatore del 
mouse per tutta la durata del trascinamento. 
In particolare, non appena viene premuto il 
pulsante del mouse sulla figura, una funzione 
calcola la posizione corrente del puntatore. 
Tale posizione, naturalmente, deve rimanere 
costante, rispetto a quella del DIV, per tutta 
l'operazione di trascinamento; altrimenti, 
appena si comincia a muovere il puntatore, 
questo andrebbe immancabilmente a posizio- 
narsi sull'angolo superiore sinistro del DIV È 
necessario quindi all'inizio, calcolare anche la 
posizione precisa del DIV, e quindi effettuare 
una correzione continua rispetto alla posizio- 
ne del puntatore del mouse, per tutta la dura- 
ta del trascinamento. 

La posizione precisa del DIV, tuttavia, non 
coincide necessariamente con le proprietà 
offsetLeft e offsetTop, visto che queste ultime 
rappresentano le distanze rispettivamente da 
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sinistra e dall'alto ma solo rispetto all'ele- 
mento contenitore. In definitiva, per ottenere 
la posizione precisa di un elemento all'interno 
della pagina, occorre sommare tutti gli 
offsetLeft (e ovviamente gli offsetTop) dei vari 
elementi, rispetto ai relativi contenitori. Tale 
operazione è svolta dalla seguente funzione: 

function trova_posizione(elemento){ 
var distanza_orizzontale = 0; 
var distanza_verticale = 0; 

while (elemento. offsetParent){ 

distanza_orizzontale += elemento. offsetLeft; 
distanza_verticale += elemento. offsetTop; 



elemento 



elemento. offsetParent; //la 



variabile elemento, ora, passa a rappresentare il 
//contenitore dell'elemento finora preso in 
considerazione 



} 



return {x:distanza_orizzontale, 
y:distanza_verticale}; //ritorno le proprietà x e y. 



} 



Questa accortezza non è necessaria, evidente- 
mente, quando l'elemento di cui si vuole calco- 
lare la posizione precisa non si trova all'interno 
di altri elementi che fungono da contenitori: ciò 
avviene, in particolare, nella seconda applicazio- 
ne di esempio, rappresentata da una semplice (e 
solo abbozzata) riproduzione del gioco della 
dama, dove esiste, tuttavia, una singola pedina, 
che può essere trascinata per tutta la superficie 
della pagina. La posizione precisa della pedina 
viene, poi, ricalcolata di volta in volta dal server 
al termine del suo trascinamento, sempre a 
mezzo di chiamate asincrone Ajax. 
A titolo di esempio, ecco qui di seguito la funzio- 
ne che corregge la posizione della pedina per 
farla rientrare perfettamente nelle caselle bian- 
che: 

function gestisci_risposta() { 



if(http.readyState == 4 || http.readyState= = 0) 
{ 

try 

{ 

var risposta = 

http.responseXML.documentElement; 

var val_nuovo_x, val_nuovo_y, stringa; 
val_nuovo_x = 
risposta. getElementsByTagName("x").item(0). fi rstChi 

ld.data.toString(); 




wmmm 



Come già citato nel testo 
dell'articolo, esistono parecchi 
f ramework che forniscono 
funzionalità molto avanzate, 
anche basate su Ajax, con poco 
sforzo. A titolo di esempio posso 
citare script. acuto. us. usato 
spesso con il f ramework 



prototype, ma ne esistono anche 
molti altri. Un f ramework 
decisamente complesso e ricco di 
funzionalità molto interessanti è 
poi Dojo, che fornisce controlli 
Ajax decisamente avanzati, 
strumenti per generare "al volo" 
grafici, menu, ecc.. 



val_nuovo_y = 
risposta. getElementsByTagName( 


'y").item(0).firstChi 
ld.data.toString(); 


stringa = 
risposta. getElementsByTagName("ancorato").item(0). 
firstChild.data.toSthngO; 






tra scina. sty le. Ieft= vai 


_nuovo_x; 




tra scina. sty le. top= vai 


_nuovo_y; 




tra scina. se tAttribute(' 


ancorato', stringa); 




trascina = nuli; 


} 


catch(e) 


{ 




alert("Attendere qualche 
effettuare la richiesta . 


secondo per 

.." + e.toString()); 


} 




} 




} 



CONCLUSIONI 

L'avvento di Ajax sta letteralmente cambiando 
il modo di pensare al Web, tanto che alcune 
applicazioni come quelle che abbiamo appena 
che rappresentano la normalità in ambiente 
desktop appaiono come una rottura della con- 
suetudine in ambiente web. Questo lascia 
intendere quanto la rivoluzione sia soprattutto 
concettuale 

Enrico Viale 
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' POSSIBILE FARE ANIMAZIONI SUL WEB 



Ovviamente la risposta è affermativa. È possibile ricorrere all'uso dei 
timer, attraverso ad esempio le funzioni setlnterval (per temporizzare 
l'esecuzione di una determinata funzione) e setTimeout (per eseguire 
uno script dopo che è passato un certo intervallo di tempo): l'anima- 
zione riguarda evidentemente la posizione di un dato elemento che 
viene aggiornata dinamicamente dal timer stesso. Per rimuovere i ti- 
mer, determinandone quindi l'arresto, viene invece impiegata la fun- 
zione clearlnterval. 
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JAVASCRIPT 
CROSS-DOMAIN 

IN QUESTO ARTICOLO IMPAREREMO AD UTILIZZARE JAVASCRIPT PER EFFETTUARE CHIAMATE 
ASINCRONE AD UN DOMINIO DIVERSO DA QUELLO DI APPARTENENZA. COME VEDREMO, 
QUESTA TECNICA CI PERMETTERÀ DI SPOSTARE IL CARICO DI LAVORO DAL SERVER AL CLIENT 




U CD U WEB 

JavaScript-Cross-Domaiiuip 



^BF 



3 



n 




REQUISITI 



■AM.WJ.HJJ, 



i^T Medie di JavaScript 



1 



Un Web browser che 
supporta JavaScript 



00 



Tempo di realizzazione 



Negli ultimi tempi si parla molto di Aj ax. Per chi 
non lo sapesse Ajax sta per Asynchronous Ja- 
vaScript and XML. Sostanzialmente è una tec- 
nologia utilizzata per effettuare chiamate asincrone 
al server per poi aggiornare dinamicamente gli ogget- 
ti della pagina Web. Come tutte le tecnologie, però, 
anche Ajax ha i suoi vantaggi e svantaggi. Tra gli aspet- 
ti negativi di maggior rilievo vi è l'impossibilità di co- 
municare con un dominio diverso da quello di appar- 
tenenza utilizzando l'elemento principe della tecno- 
logia Ajax, ossia l'oggetto XMLHttpRequest. In que- 
st'articolo vedremo come sia possibile ovviare a tale 
problema. A riprova di ciò, svilupperemo una sempli- 
ce applicazione che interroga uno dei Web service 
esposti da Yahoo! per recuperare le ultime news su un 
qualsiasi argomento scelto dall'utente. La figura 1 mo- 
stra uno screenshot dell'applicazione di esempio. 
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F/£. 1: Screenshot relativo alla nostra applicazione. 



IL PROBLEMA 

Il problema di cui stiamo parlando viene identificato 
in inglese con i termini cross-domain restrìction, os- 
sia le impostazioni di sicurezza, insite nei moderni 
Web browser, sono tali da consentire chiamate al so- 
lo dominio da cui la pagina Web è stata generata. Ciò 
significa che utilizzando un linguaggio che gira lato 



client, come JavaScript, non potremmo effettuare chia- 
mate a domini differenti da quello di appartenenza 
dello script. Ho detto "non potremmo" proprio per- 
ché, come vedremo, esiste un modo per aggirare que- 
sta fastidiosa restrizione. Essa, infatti, non ci permet- 
te (usando JavaScript) di utilizzare i vari servizi Web 
data la loro natura di trovarsi in domini completa- 
mente diversi. La figura 2 dovrebbe chiarire la pro- 
blematica oggetto della discussione. 



CLIENT 

(La tua 

applk azione 
Web) 


XMLHnpRequest 


JLTUO 

WEB 

SERVER 


OK 







CLIENT 

(Lli tua 

applicazione 

Web) 



XMfcHtti 




WEB SERVER 
^A DIVERSO 
DAL TUO 



NO 

Fig. 2: Problema della restrizione cross-domain. 

Al problema illustrato, in realtà, esistono diverse so- 
luzioni, tra le quali: 

• Utilizzare mod_rewrite o mod_proxy di Apache 
per passare la richiesta dal nostro server a qual- 
siasi altro. Così facendo il client saprebbe di avere 
a che fare con lo stesso dominio da cui è arrivata 
l'applicazione JavaScript e quindi non ci sarebbe- 
ro problemi. Apache si occuperebbe dello "spor- 
co lavoro" di fare il redirect verso server deside- 
rato. 

• Applicare una firma digitale agli script. Questa 
soluzione, però, non è molto praticabile se non 
altro perché, al momento in cui sto scrivendo, è 
supportata soltanto da Firefox. 

• La soluzione che viene più spesso utilizzata è 
quella di usare un proxy. Il problema con questo 
tipo di approccio risiede nel fatto che bisogne- 
rebbe configurare il proxy in modo tale che, per 
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ragioni di sicurezza, non passi le richieste verso 
qualsiasi dominio. Inoltre, utilizzare un proxy, o il 
mod_rewrite di Apache non fa altro che aggiun- 
gere un anello alla catena che porta la nostra 
applicazione client a comunicare col server desi- 
derato. Ciò comporta un abbassamento delle 
performance. 
• L'approccio ideale sarebbe quello di trovare una 
soluzione che ci permetta di mettere in comuni- 
cazione diretta il client e il server senza interme- 
diari. Guarda caso tale soluzione è oggetto del 
presente articolo. Le tecnologie sfruttate per rag- 
giungere questo scopo sono JSON e la creazione 
dinamica del tag <script>. Quest'ultima va a 
sostituire l'oggetto XMLHttpRequest per effet- 
tuare le chiamate asincrone al server. 



CREAZIONE DINAMICA 
DEL TAG <SCRIPT> 

L'uso più comune che si fa del tag <script>, è di inse- 
rire pezzi di codice JavaScript all'interno di una pagi- 
na HTML o di includere un file JavaScript esterno. 
Questo tipo di utilizzo è statico. In altre parole, all'at- 
to della scrittura della pagina HTML, inseriamo i tag 
<script> necessari a raggiungere i nostri scopi. Non 
tutti sanno, tuttavia, che è possibile utilizzare il 
DOM (Document Object Model) per includere il 
suddetto tag dinamicamente. Vediamo come ciò sia 
possibile. Supponiamo di avere una pagina HTML e 
di voler includere, in modo dinamico, uno script 
nella sezione <head> della stessa. Per effettuare tale 
operazione è sufficiente utilizzare il seguente codice 
JavaScript: 

// punta alla sezione head 

var headLocation = document.getElementsBy 

TagName("head").item(0); 
// costruisce lo script da inserire 
var script = document.createElement("script"); 
script.type = "text/javascript"; 
script.src = "test.js"; 
// include lo script dinamicamente 
headLocation. appendChild(script); 



Come potete vedere non è niente di complicato. La 
prima riga di codice ottiene un riferimento al tag 
<head> del documento. In seguito viene costruito lo 
script da inserire di modo che abbia il seguente for- 
mato: 



<script type="text/javascript" src="./test.js"> 

Il file test.js contiene la singola istruzione: 
alert("Ciao Mondo!"); 



</schpt> 



L'ultima riga non fa altro che aggiungere lo script in 
oggetto come nodo figlio di <head>. Il risultato di 
tutto ciò è la visualizzazione di un alert contenente 
la stringa "Ciao Mondo!". Chiaramente avremmo 
potuto ottenere lo stesso risultato in modo più sem- 
plice. La potenza di ciò che abbiamo fatto sta nell'a- 
ver aggiunto lo script in modo dinamico e non stati- 
camente. Quello che avviene quando viene incluso 
un tag <script> dinamicamente è che il suo codice 
(l'URL dello script) viene eseguito al volo. Per pro- 
varlo facciamo un altro esempio utilizzando JSON. 
Non entrerò nel dettaglio di JSON dato che ne abbia- 
mo già parlato in diversi articoli per ioProgrammo. 
Potete, tuttavia, avere un assaggio su JSON leggendo 
il box laterale. Tornando al nostro esempio, suppo- 
niamo di avere una funzione che si aspetta in ingres- 
so un oggetto in formato JSON e ne visualizzi la pro- 
prietà cognome. Tale oggetto avrà la seguente strut- 
tura: 



{ 


"cognome 


" : "Lacava", 


"nome" : 


'Alessandro" 


} 



Per chiarire un po' le cose avremo una pagina HTML 
così composta: 

<html> 
<head> 
</head> 



<body> 



<script> 




ora ira BREVE 



JSON sta per JavaScript Object No- 
tation. Per chi avesse dei dubbi al 
riguardo, JSON non è né un lin- 
guaggio né una tecnica di program- 
mazione. Esso è semplicemente un 
formato leggero di interscambio 
dati che utilizza la notazione lette- 
rale di JavaScript per rappresentare 
oggetti ed array. Sostanzialmente, 
quindi, è un sottoinsieme di Java- 
Script. Non entrerò nel dettaglio di 
JSON dato che gli è stato dedicato 
un intero articolo su ioProgrammo 
N. 108 - Novembre 2006. In breve, 
un oggetto, in JSON, è rappresenta- 
to con la seguente sintassi: 




Utilizzare un proxy 
per effettuare 
chiamate cross-domain 
con XMLHttpRequest: 

http://developer. yahoo. 

com/javascript/howto- 

proxy.html 

Qui potete trovare 

un articolo 

interessante 

di Jason Levitt: 

http://www.xm I .com/ 

pub/a/2005/12/21/json- 

dvnamic-script-taq.html 

Documentazione sul 

servizio di ricerca news 

esposto da Yahoo!: 

http://developer. yahoo. 

com/search/newsA/1/new 

sSearch.html 

Qui, invece, trovate 

tutte le risorse 

necessarie che Yahoo! 

dedica ai 

programmatori 

JavaScript/Ajax: 

http://developer. yahoo. 

com/javascript/ 



Il precedente esempio rappresenta, 
in modo letterale, l'oggetto Perso- 
na. Per rappresentare un array, in- 
vece, si usa la seguente sintassi: 



{ 


"linguaggi" : [ 


"Java", 


"C#", 


"JavaScript" 


1 


} 



J 

"cognome" : "Lacava", 
"nome" : "Alessandro" 
"anni" : 30 



Abbiamo così creato l'array lin- 
guaggi. Per interpretare un ogget- 
to/array JSON in JavaScript si può 
utilizzare la funzione eval. Esistono 
anche diverse librerie lato server 
per mappare da linguaggi come 
PHP, Java e C# a JSON. Maggiori 
info su JSON li potete trovare sul si- 
to ufficiale, all'indirizzo: 
http://www.ison.org 
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// punta alla sezione head 



var headLocation = document.getElementsByTag 

Name("head").item(0); 



// costruisce lo script da inserire 



var script = document.createElement("script"); 



script.type = "text/javascript"; 



script.src = "./test.js"; 



// inserisce lo script dinamicamente 



headLocation. appendChild(script); 



mezzo di un parametro della query string. Fortunata- 
mente Yahoo! fornisce questo tipo di servizio per al- 
cuni dei suoi Web service. La parte restante dell'arti- 
colo si occuperà proprio dello sviluppo di un'appli- 
cazione JavaScript che invochi il Web service di Yahoo! 
relativo alla ricerca delle news dato un argomento. 
Per "complicare" (si fa per dire) un po' di più le cose l'ap- 
plicazione includerà una combo box che permetterà 
di scegliere la lingua in cui cercare le news. 



// visualizza la proprietà cognome 



function displayLastName(person) 



{ 



alert(person. cognome); 



} 



</script> 



</body> 



</html> 

Inoltre, questa volta, il file test.js deve contenere il 
seguente codice: 

displayLastlMame({"cognome" : "Lacava", "nome" : 

"Alessandro"}); 

Lanciando la pagina HTML notiamo che viene visua- 
lizzata la proprietà cognome, come ci aspettavamo. 
Questo conferma quanto detto in precedenza, in al- 
tre parole il codice dello script dinamicamente ag- 
giunto viene eseguito "on the fly". Tale risultato è im- 
portantissimo poiché possiamo far puntare l'URL, in- 
serito nell'attributo src di <script>, a qualsiasi domi- 
nio siamo interessati.Rimane un piccolo problema 
facilmente risolvibile. L'URL puntato deve restituire 
il risultato in formato JSON come argomento di una 
funzione di callback. Tale funzione la specifichiamo per 



UN CHIARIMENTO SU AJAX 



Si è parlato talmente tanto di 
Ajax in questo periodo che si è ve- 
nuta a creare una grande confu- 
sione su cosa sia e a cosa serve. 
Ajax sta per Asynchronous Java- 
Script + XML. Il termine è stato co- 
niato da Jesse James Garrett, pre- 
sidente di Adaptive Path, in un ar- 
ticolo che potete trovare al se- 
guente link: 

http://www.adaptivepath.com/publi- 
cations/essavs/archives/000385.php 
In sostanza, Ajax è un insieme di 
tecnologie utilizzate congiunta- 
mente per sviluppare applicazioni, 
cosiddette, Web 2.0. Di quest'in- 
sieme di tecnologie fanno parte: 

1. (X)HTML e CSS, utilizzati per lo 
strato di presentazione. 



2. DOM, per interagire dinamica- 
mente col documento. 

3. XML, come formato di inter- 
scambio dati. 

4. XMLHttpRequest, per il recupe- 
ro asincrono dei dati. 

5. JavaScript, come "collante" 
delle precedenti. 

C'è da dire, tuttavia, che non è ob- 
bligatorio utilizzare XML come 
formato di interscambio dati. In 
alcuni contesti è preferibile usare 
JSON o qualche altro formato cu- 
stomizzato. A tal proposito occor- 
re precisare che JSON non è alter- 
nativo ad Ajax ma può essere uti- 
lizzato in congiunzione a quest'ul- 
tima tecnologia come sostituto di 
XML per rappresentare i dati. 



L'APPLICAZIONE 
DI ESEMPIO 

La figura 1 mostra uno screenshot dell'applicazione 
di esempio. Quest'applicazione è composta da: 

• Un file HTML. 

• Un foglio di stile rappresentato da un file CSS. 

• Tre file JavaScript. 

I primi due rappresentano la GUI mentre i file JavaScript 
hanno la responsabilità di recuperare le news e co- 
struire il codice HTML da inviare alla GUI. 
Vediamo tutto il giro dell'applicazione partendo dal sin- 
golo file HTML. Quello che segue è il codice della se- 
zione <head> del file in questione: 

<link rel="stylesheet" href="./style.css"/> 

<script src="./scripts/WebServiceRequester.js" type= 

"text/javascript"> </script> 
<script src="./scripts/QueryPerformer.js" type="text/ 

javascri pt"> </scri pt> 
<script src="./scripts/ResultProcessor.js" type="text/ 

javascri pt"> </scri pt> 

<script type="text/javascript"> 

// esegue la query (la chiamata al WS) 
function performRequest() 

{ 

// svuota il contenuto del box 

delle news 
document.getElementByld 

("newsBody").innerHTML = ""; 
// recupera i dati del form 
var query = document.search 

Form.searchText.value; 
var language = document.search 

Form.searchLanguage.value; 



// istanzia il QueryPerformer 



passando il nome della funzione di callback 



// da richiamare quando la 



chiamata al W.S. ritorna 



var queryPerformer = new 



QueryPerformer("wsProcessResult"); 



// chiama il Web service 



queryPerformer.execute(query, 

language); 
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QueryPerformer.prototype.execute 



</script> 

Come si può vedere, precedente codice "linka" il fo- 
glio di stile. In seguito include i tre file JavaScript che 
si occupano del recupero delle news. Dopodiché vie- 
ne definita la funzione performRequest che avvia la ri- 
cerca delle news. Come avrete intuito, questa funzio- 
ne viene chiamata non appena viene cliccato il bot- 
tone 'Avvia Ricerca". Per tale motivo è inserita come va- 
lore dell'attributo action del form: 

<form id="searchForm" name="searchForm" 

action="javascript:performRequest();"> 

La funzione performRequest recupera i dati del form, 
ovvero testo da cercare e lingua in cui si desiderano i 
risultati. In seguito istanzia un oggetto della classe 
QueryPerformer che utilizza per eseguire la query re- 
lativa alla ricerca. Per ragioni di spazio non sarà visto 
il foglio di stile che è abbastanza semplice. Lo potete, 
tuttavia, trovare nel codice allegato. Vediamo, inve- 
ce, la parte più importante dell'applicazione, ovvero 
i file favaScript. Quello che segue è il codice del co- 
struttore di QueryPerformer: 

function QueryPerformer(callback) 

{ 

this.searchllrl = "http://search.yahooapis. 

com/NewsSearchService/Vl/newsSearch"; 
this.appld = "YahooDemo"; 
this. output = "json"; 
// controlla che callback sia passata 



if(!callback || callback. length == 0) 

{ 

throw new Error("l_a funzione di 
callback è un parametro obbligatorio!"); 

} 

this. callback = callback; 

} 



Il parametro passato in ingresso rappresenta la fun- 
zione di callback da chiamare. In pratica è quella che 
riceverà il risultato della ricerca in formato ISON. Il 
costruttore, inoltre, definisce: 

• searchUrl: l'URL che punta al Web service di Yahoo! 

• appld: 1ÌD da utilizzare per la chiamata. Da nota- 
re che quello usato è un ID temporaneo. Convie- 
ne registrarsi sul sito diYahoo! per ottenerne uno 
full. 

• output: il formato in cui desideriamo i dati. Nel 
nostro caso JSON. Se tale parametro non è speci- 
ficato, viene utilizzato come default il formato XML. 

La classe QueryPerformer ha un solo metodo, exe- 
cute, che viene invocato da performRequest: 



function(query, 

language) 



[■■■] 



// uri completo 



var fullUrl = this. searchUrl + "?" + 



"appid=" + this.appld + 



query=" + query + 



"&language=" + language + 



"&output=" + this. output + 

"&callback=" + this. callback; 



// effettua la chiamata al servizio 



var requester = new JSONscriptRequest 



(fullUrl); 



requester.buildScriptTagO; 



requester.addScriptTag(); 



}; 



Questo metodo esegue alcuni semplici controlli che 
abbiamo omesso per praticità. In seguito costruisce 
l'URL completo che passa poi al costruttore della clas- 
se JSONscriptRequest. Tale classe è stata scritta da Ja- 
son Levitt. Non sarà analizzata per ragioni di spazio. 
Non è molto complessa e la potete in ogni caso trova- 
re nel codice allegato. Vi basti sapere che tale classe è 
responsabile della costruzione dello script e la sua 
aggiunta dinamica alla sezione <head> del file HTML. 
La classe si trova nel file WebServiceRequester.js. 
Rimane da esaminare la funzione di callback che vie- 
ne invocata non appena la chiamata al Web service 
ritorna. Se ricordate, il nome di tale funzione è stato 
passato come parametro al costruttore di Query- 
Performer. La funzione si aspetta un oggetto, in forma- 
to JSON, con la seguente struttura "imposta" dal ser- 
vizio Web diYahoo!: 



J 

"ResultSet": 

{ 

"totalResultsAvailable":"2824", 

"totaIResultsReturned": 10, 

"firstResultPosition":"l", 

"Result": 

[ 



"Title": "Exploit per 
Vista? 50 mila dollari, grazie! 



"Summary":"Nel 
mercato nero degli hackers. 



"Uri": "http:VVit.news. yahoo. 



comV19122006V255Vexploit-per-vista. 



"ClickUrl":"http:V 



Vit.news.yahoo.comV19122006V255\ 



/exploit-per-vista. 



"NewsSource'VTom's Hardware 




Guide Italia via Yahoo! Italia Notizie", 



http://www.ioprogrammo.it 



Maggio 2007/ 59 ► 



056-060 28-03-2007 14:55 Pagina 60 



ioProgrammo Web T B Applicazioni remote lato client 




"NewsSourceUiT':"http:\/\/it. 



news. yahoo. comV", 



"Language":"it", 



"PublishDate":"1166508455" 



"ModificationDate": "1166508552" 



}, 



Le proprietà di tale oggetto sono: 

• totalResultsAvailable: indica il numero totale di 
risultati disponibili. 

• totalResultsReturned: è il numero di risultati 
ritornati. Per default il servizio restituisce 10 risul- 
tati. È possibile modificare questo valore specifi- 
cando il parametro results nella query string. 

• firstResultPosition: indica la posizione del primo 
risultato. Anche questo parametro lo potete 
modificare agendo sui valori specificati nella 
query string. In un box laterale è indicato il link in 
cui potete trovare una descrizione completa dei 
parametri che è possibile utilizzare per persona- 
lizzare al massimo la query. 

• Result: tale proprietà è un array dove ogni ele- 
mento rappresenta una news. Non entriamo nel 
dettaglio delle proprietà concernenti la singola 
news poiché autoesplicative. 

La definizione della funzione di callback si trova nel 
file ResultProcessor.js. Eccone il codice: 

function wsProcessResult(obj) 

{ 

var totalResultsReturned = obj.ResultSet. 

totalResultsReturned; 
if(totalResultsReturned == 0) 

{ 

addNews("Nessuna news 

disponibile"); 
return; 



for(var i = 0; i < totalResultsReturned; i++) 

< 

// news corrente 



QUALI RESTRIZIONI? 



Vi sono dei limiti, imposti da Yahoo!, per quanto riguarda il numero 
massimo di query che è possibile sottoporre al servizio. Per quanto ri- 
guarda il Web service delle news tale limite è fissato, al momento in cui 
scrivo, a 5000 query al giorno per ogni indirizzo IP. Per avere maggiori 
informazioni al riguardo vi consiglio di puntare il vostro browser al se- 
guente URL: http://developer.vahoo.com/searcri/rate.ritml 



var news = obj.ResultSet. 



Resultp]; 



// recupera i dati relativi alla news 



corrente 



var newsTitle = news.Title; 



var newsSummary = news. 



Summary; 



var newsUrl = news.ClickUrl; 



// costruisce l'HTML relativo alla 

news da visualizzare 



var newsToDisplay = "<a class= 



'title' target='_blank' href="' + newsUrl + "'>" + 



newsTitle + "</a>" 



newsToDisplay += "<br/>"; 



newsToDisplay += "<a class= 



'summary' target='_blank' href='" + newsUrl + 



"'>" + newsSummary + "</a>" 



newsToDisplay += "<br /> 



<br/>" 



//aggiunge la news al blocco 



addNews(newsToDisplay); 



} 



Questa funzione controlla se il numero di news rice- 
vute è zero. In tal caso visualizza un messaggio adat- 
to ed esce. La parte più interessante è, ovviamente, il 
loop. Esso cicla sull' array Result che, come abbiamo 
visto, contiene le news ricevute dal servizio. Per ogni 
news il loop recupera titolo, descrizione e uri alla 
news completa. Con tali dati costruisce il codice 
HTML da inserire nel <div> (il cui id è newsBody) 
della pagina HTML. L'aggiunta vera e propria della 
news viene fatto dalla funzione addNews: 



function addNews(newsToDisplay) 


{ 


document.getElementById("newsBody"). 




innerHTML += 


newsToD 


isplay; 


} 



Essa, semplicemente, appende l'HTML passato 
come parametro, ovvero la news, al corpo del div 
newsBody. 



CONCLUSIONI 

Utilizzando gli script dinamici, è possibile sviluppa- 
re potenti applicazioni che recuperano dati da un 
Web service tramite l'uso del solo JavaScript. Il van- 
taggio principale di un approccio simile, risiede nel 
fatto che nostro server non risente per niente del 
carico relativo alla comunicazione col servizio. Tutta 
la logica relativa al recupero, parsing e visualizzazio- 
ne delle news, si trova lato client (JavaScript). 

Daniele De Michelis 
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JYTHON: FONDE 
PYTHON CON JAVA 

ECCO COME RACCOGLIERE IN UNICO LINGUAGGIO LA COMPLETEZZA DEL COMPILATORE 
DI SUN CON L'ELEGANZA E LA SEMPLICITÀ DI PYTHON. IN QUESTO NUMERO REALIZZEREMO 
ESEMPI COMPLESSI CON POCHISSIME RIGHE DI CODICE 




LI CD U WEB 

Jython.zip 



^ 



é 




REQUISITI 



H.I.I.W-J.UJJ1. 
55] Basidi 

programmazione Java, 
Python e di database 



A 



JDK 1.4.1 o superiore, 
Jython, MySQL 



S^gUS] 



Molte applicazioni cercano di coinvol- 
gere l'utente usando una grafica accat- 
tivante, permettendo di ottenere una 
gran quantità di informazioni con pochi colpi di 
mouse. Anche il web, con AJAX, cerca di rende- 
re la vita del navigatore più semplice e piace- 
vole. In questo contesto si inserisce Jython, il 
fortunato incontro tra Python e Java: tra due co- 
lossi del genere non poteva che nascere uno 
strumento potente che sfrutta la flessibilità del- 
l'uno e la ricchezza dell'altro. In questo artico- 
lo si daranno le basi per conoscere e usare Jython 
con molti esempi da sfruttare subito. L'articolo 
è diviso nelle due maggiori aree di utilizzo di 
Jython: le interfacce grafiche e i collegamenti 
al database. Come i libri di cucina, potete ve- 
dere i piatti da cucinare nelle foto e, di conseguen- 



COME INIZIARE 



Il primo passo è installare una versione del 
Java Development Kit. In allegato con al 
codice, trovate il file di installazione di Jython. 
È necessario eseguirlo come programma Java 
perché è un file .jar (su Windows, c'è il 
riferimento usando il tasto destro). A questo 
punto gli esempi sulle GUI sono funzionanti. 
Per quelli relativi al db, è necessario installare 
MySQL o, in alternativa, PostgreSQL. Negli 
esempi, per praticità, si fa riferimento solo a 
MySQL; nel codice ci sono le istruzioni anche 
per PostgreSQL. Negli esempi sul db si fa 
riferimento al db chiamato loP e a una tabella 
il cui script è presente in allegato (script.sql). 
Per eseguire gli esempi, serve andare nella 
directory nella quale è installato Jython (quella 
contente jython.bat), e copiare la directory loP 
(che contiene gli esempi dell'articolo) e il file 
dbexts.ini (directory e file sono in allegato alla 
rivista). A questo punto, basta lanciare il 
comando jython loP\banner.py e tutti gli altri 
esempi. Per visualizzare gli esempi proposti 
basta un semplice editor di testo o un tool di 
sviluppo. In questo caso, se si usa eclipse, c'è il 
plugin specifico per Jython che si trova al 
seguente indirizzo: 
http://www.redrobinsoftware.net/jydt/ 



za, provare a realizzarli tutti in maniera sequen- 
ziale oppure passare a quello che vi sembra più 
appetitoso. 



INTERFACCE GRAFICHE 
UHI SEMPLICE INIZIO 

Per iniziare nel modo più semplice e intuitivo, 
si può partire con un po' di interfacce grafiche, 
GUI, Graphical User Inter faces, che mostrano 
immediatamente uno degli utilizzi che si può 
fare di Jython. I risultati dei nostri primi sforzi 
sono mostrati in figura 1, 2 e 3. Tanto per far 
capire l'estrema facilità del codice, si può già 
dire che le righe di codice del primo esempio 
sono 20 in tutto! E nonostante questo ci posso- 
no essere già dei primi spunti per riflettere sul- 
le potenzialità di Jython. 

# File: banner.py 

from java import awt 

import java # import delle classi java 

class Banner(awt.Canvas): 
def paint(self, g): 

g. color = 204, 204, 204 

message = "Hello word!!!" 

top_frame = awt.Frame("Jython Banner", size = 

(350, 150), 

windowClosing = lambda e: 

java.lang.System.exit(O)) 
top_frame.add( BannerQ ) 
top_frame. visitile = 1 

Come si può vedere dal codice, il commento 
della prima riga ricorda che il file è di tipo .py, cioè 
interpretabile da Python. Eppure, immediatamen- 
te sotto, l'istruzione di import è molto simile a 
quelle usate in Java. In poche parole, serve Jython 
che unisce la potenza di Java e la flessibilità di 
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Python. Un'altra considerazione che salta al- 
l'occhio è la definizione di class, che serve pro- 
prio a creare una classe, cioè la base della pro- 
grammazione ad oggetti. L'esempio sfrutta Ja- 
va anche per creare degli oggetti che apparten- 
gono al pacchetto grafico AWT, come Canvas. 
Il metodo paint può essere modificato a piaci- 
mento e con semplicità per cambiare i colori o 
il testo del messaggio. Le altre istruzioni servo- 
no per creare e rendere visibile la finestra crea- 
ta. E fin qui si sono esplorati i confini del mon- 
do Java. Python subentra per gestire facilmen- 
te la chiusura della finestra. Quindi, già questo 
primo esempio, semplice nella realizzazione e 
nel codice, lascia già intravedere le enormi pos- 
sibilità che può offrire la fusione tra Java e Python. 



panel, add(mybutton) 



La maggior parte delle istruzioni utilizzate in 
questo esempio, sono del tutto analoghe a quel- 
le dell'esempio precedente. L'elemento aggiun- 
tivo è il bottone, che viene inserito nella fine- 
stra. Il codice offre lo spunto per parlare una 
caratteristica usate da Jython per velocizzare e 
rendere più compatta la scrittura del codice. 
Nota con il nome di Proprietà dei Bean, con- 
sente di accedere alle variabili in modo diretto 
senza passare dai metodi get e set. Inoltre, si 
possono passare al costruttore i parametri co- 
me parole chiave. L'istruzione vista in prece- 
denza, awt.Frame(title="Hello", background = 




Figura 1: ecco come appare la nostra prima applica 
zione 



A questo punto si può passare all'esempio del- 
la figura 2 che è la naturale evoluzione del pre- 
cedente. 




Figura 2: Aggiungere un bottone è un'operazione non 
complessa 



# File: halloJythonGUI.py 



# Funzione exit per chiudere la finestra 



Figura 3: GUI con immagine 

awt.Color.yellow, windowClosing=exit) serve per 
creare un oggetto Frame e per impostare le sue 
proprietà. Quello che Jython fa in una riga di 
codice, Java lo farebbe con il codice seguente. 

Frame myframe = new Frame("Hallo"); 
myframe.setBackground(Color.yellow); 
myframe.addWindowListener(new 

SomeWindowListenerClass()); 

Per concludere questi primi esempi introdut- 
tivi, si può passare alla figura 3 che mostra una 
finestra contente un'immagine. 

Il codice relativo offre un altro spunto. 



def exit(e): 



java, la ng. System. exit(0) 



# 


Fi 


e immagine 


py 










if 




name = = 


' main 


'; 








f 


= immagine 


("jython- 


new 


small 


gif") 



# Definizione della finestra 



top_frame = awt.Frame(title="Hallo" 



background = awt.Color.yellow, 



windowClosing=exit) 



# Definizione del bottone e relativa azione 



mybutton = awt.Button("OK", 



action Performed = exit) 



# Aggiunta del bottone 



Nel codice sono presenti nomi che iniziano e 
finiscono con " ". Ce ne possono essere di di- 
verso tipo e sono variabili speciali. Nel nostro 
caso servono a dire che, se il chiamante è il main 
cioè si è lanciato a riga di comando proprio il 
file immagine. py, allora si eseguono le istruzio- 
ni successive, cioè l'inserimento dell'immagine. 
Per chi mastica Java, è l'equivalente di public 
void main (Stringi] args). 




DOVE TROVO 
MYSQL 

Il popolare database 
può essere scaricato 
dal sito: 

http://dev.mysql.com/ 
clown loacls/ 
Da questo indirizzo 
si può scegliere 
quale versione 
scaricare. Una è 
gratuita e non ha 
supporti tecnici, 
l'altra, a pagamento, 
è indicata per chi ha 
bisogno di aiuto. Tra 
gli strumenti utili 
per gestire il db, 
si segnalano i GUI 
Tools, programmi 
con interfacce 
semplici che 
consentono di creare 
e modificare il db. 
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GESTIONE 
DEGLI EVENTI 

Dopo aver visto gli esempi introduttivi che spie- 
gano le basi di Jython si può passare alla gestio- 
ne degli eventi che, a dir la verità, risulta an- 
ch'essa semplice. 

Le figure 4 e 5 mostrano una finestra con un 
normale menù a tendina. Scegliendo una voce 
del menù, compare una scritta relativa all'ope- 
razione eseguita. 



EBE 



New 

Open 

Save 



Saveas 



Close 



1 



Figura 4: Menu di scelta 



# File: menu.py 



[ 



('File', ['New', 'Open', 'Save', 'Saveas', 'Close']), 



r 


ninirxi i 


1 - H 1 « | 


File Edit 


JEvent: onSaveas 



Figura 5: Azione del menu 



sione di tutti i suoi elementi per associare a ogni 
voce l'azione da eseguire. Vi è poi l'istruzione 
semplice e compatta System. exit( 0) per utiliz- 
zare la chiusura della finestra con Jython. Infi- 
ne c'è l'esempio di una funzione che viene chia- 
mata quando si sceglie una voce dal menù. 
In questo blocco di codice si può fare una con- 
siderazione per velocizzare la scrittura del codi- 
ce, che è la missione di Python. Infatti, per ge- 
stire gli eventi chiamati dal menù, basta usare una 
sola istruzione: actionPerformed=method. Ge- 
neralizzando, la Gestione degli eventi con Jython 
è resa estremamente semplice e compatta. Al- 
tri esempi che illustrano gli eventi sono i bot- 
toni per chiudere le finestre. 
Con questi file si ha un'idea di cosa può fare 
Jython e di come lo si può utilizzare. I file succes- 
sivi sono una serie di esempi che danno altri 
strumenti utili per la gestione delle interfacce 
grafiche. 



('Edit', ['Copy', 'Cut', 'Paste']), 



class MenuTest(awt.Frame): 



def init (self): 



bar = awt.MenuBar() 



for menu, menuitems in menus: 



menu = awt.Menu(menu) 



for menuitem in menuitems: 



method = getattr(self, 'on%s' % 

menuitem) 

item = awt. Menuitem 

(menuitem, action Performed = method) 



menu.add(item) 



bar.add(menu) 



self.menuBar = bar 



self.windowClosing = lambda e: 

System. exit(0) 
self.eventLabel = awt.l_abel("Event: ") 



self, add (self. eventLa bel) 



def onNew(self, e): 



self.eventLabel. text = "Event: onNew" 
In questa parte di codice c'è la dichiarazione 
della matrice che costituisce il menu e una scan- 



ESEMPIO DI GUI: 
AGENDA 

Molte applicazioni devono essere testate inse- 
rendo dei parametri in ingresso e verificando il 
comportamento dell'applicazione. Alcuni pro- 
grammi servono per la gestione del personale. 
Prendendo spunto dall'esempio successivo, si può 
creare un'agenda o, in generale, un form nel 
quale inserire i dati. Anche in questo caso l'ope- 
razione non è particolarmente complessa. 
Il risultato è mostrato in figura 6 e di seguito ci 
sono le parti di codice più utili. 



;Vd il j^- 


flijfjji 






1 


Catego ry: 
Name: 
Address: 
City. 




Address Book 






Family ^J 




j 


Business p 


London 


State: 


|UK zip: 


|3BB1 



Figura 6: Ecco come apparirà la nostra agenda al ter- 
mine del lavoro di programazione 



# File: agenda. py 



from pawt import GridBag 
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bag = GrìdBag(pane, fill = "HORIZONTAL") 
map(category.add, ["Family", "Friends", 



"Business"]) 



bag. add( la bel Factory ("Category: ")) 
bag.addRow(category, anchor="WEST" 



fill = "NONE") 



address = awt.TextField(35) 



bag. add( la bel Factory ("Address: ")) 
bag.addRow(address) 

Oltre alla definizione dell'array direttamente 
dove serve, è da notare una classe specifica di 
Jython per la gestione delle interfacce: GridBag. 
Questa classe si può utilizzare come elemento 
che gestisce le altri classi Java semplificando- 
ne l'utilizzo. 



REALIZZIAMO 
UHI ALBERO 

Spesso capita di dover mostrare la mappa del 
proprio sito, oppure di dover illustrare le direc- 
tory del file system. Il codice del prossimo esem- 
pio calza benissimo per questi scopi, come mo- 
strato in figura 7. 





□^■■■aiaiai 


~H Radice 

Q Fogliai 
? [3 Nodo 

Foglia2 



Figura 7: Ecco la rappresentazione dell'albero 



Di seguito vengono riportate le istruzioni più 
significative. 

# File: albero. py 

top_frame = swing. JFrame("Albero", 

windowClosing = lambda e: 

sys.exit(O), 

background = (180,180,200), ) 
data = tree.DefaultMutableTreeNode("Radice") 
data.add(tree.DefaultMutableTreeNode("Foglial")) 
childNode = tree.DefaultMutableTreeNode("Nodo") 
chi ldNode.add(tree.DefaultMutableTreeNode(" Fogli 

a2")) 

data.add(childNode) 
t = swing. JTree(data) 



Ormai molti concetti sono noti: proprietà dei 



bean e gestione degli eventi nel costruttore. Gli 
elementi aggiuntivi sono specifici per la gestio- 
ne degli alberi e sono la creazione della radice, 
dei nodi e delle foglie. 



ESEMPIO DI GUI: 
DRAG & DROP 

Una delle caratteristiche delle interfacce grafi- 
che che serve a semplificare la vita dell'utente 
è senza dubbio il Drag & Drop. Con un sempli- 
ce trascinamento del mouse, chiunque può spo- 
stare un elemento da una parte all'altra della 
finestra senza dover eseguire operazioni com- 
plicate. 

Le figure 8 e 9 mostrano la situazione prima e do- 
po lo spostamento. 



m 


Jython Drag -n- Drop Im pieni... |-|| 




1 

2 




li j 


4 
5 







Figura 8: Drag and drop prima 





\m 




13 Jython Drag -n- Drop Ini pieni... |_ 


1 
2 


3 
3 


e::::::::::::::::] 


4 
5 









Figura 9: Drag and Drop dopo 



# File: dragNDrop.py 



from java.awt import dnd 



class JythonDnD(awt.Frame, 



dnd.DragSourceListener, 

dnd.DragGestureListener): 



self.draglist = awt.List() 



map(self.draglist.add, ["1","2","3","4","5"]) 



self.droplist = droplist([]) 



self.dropTarget = dnd.DropTarget(self, 



dnd.DnDConstants.ACTION_COPY_OR_MOVE, 



self.droplist) 



def dragGestureRecognized(self, e): 

item = self.draglist. getSelectedItem() 
e.startDrag(self.dragSource.DefaultCopyDrop, 

datatransfer.StringSelection( item), self) 




POSTGRESQL 

In alternativa a MySQL 

si può utilizzare 

facilmente anche 

PostgreSQL, 

semplicemente 

cambiando i parametri 

di configurazione 

dell'uri di connessione 

come riportato nel file 

dbexts.ini. 

Il popolare database 

può essere scaricato 

dal sito: 

htt p ://www. postgresql. 

ora/ 

A differenza di MySQL, 

è in linea tutta la 

documentazione 

scaricabile 

gratuitamente. Anche 

per questo db c'è la 

possibilità di usare 

delle comode 

interfacce grafiche. 
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PYTHON 

Per chi volesse 

conoscere tutto su 

Python può far 

riferimento al sito: 

http://www.pvthon.rt/ 

Appena si entra, ci 

sono riferimenti 

all'utilizzo che viene 

fatto di Python, come 

è avvenuto, ad 

esempio, per il sito di 

Google. 



Dal codice si può osservare l'utilizzo della clas- 
se Java dnd che semplifica tutto il processo gra- 
zie ai suoi metodi e alle costanti. E poi il meto- 
do che si occupa di spostare gli elementi. 
Anche questa funzionalità che arricchisce enor- 
memente l'usabilità delle applicazioni è con- 
tenuta in sole 60 righe di codice. 



ESEMPIO DI GUI: 
LAVAGNA 

Ultimo esempio proposto per le interfacce è la 
lavagna. Elemento un po' controverso (quante 
volte nella vita si usa una lavagna elettronica?) 
è spesso presente nelle applicazioni, soprattut- 
to quelle multimediali. Sicuramente è di gran- 
de effetto scenico. 
La figura 10 ne mostra un esempio. 




Figura 10: Non è certo un disegno artistico, ma la 
nostra lavagna ci consente di dare libero sfogo a 
tutto il nostro estro 



# File: scribble.py 



def init (self): 



Panel. init (self, BL()) 



self.add(Button('Clear', 

action Performed = self. doClear) 



BL.SOUTH) 



self.mouseDragged = self.doDrag 
self.mousePressed = self.doPress 



def doDrag (self, event): 



g = self.graphics 



g. color = Color.black 



Ix, ly = self. last 



event. x; y = event. y 



g.drawLine(lx, ly, x, y) # disegna la linea 



self. last = x, y 



def doPress (self, event): 



self. last = event. x, event. y 

Il codice mostra come memorizzare i movimen- 
ti del mouse e quando disegnare le linee. Con 



questi esempi si conclude la parte delle interfac- 
ce grafiche per lasciare il posto alla gestione dei 
dati. 



PERSISTENZA DEI DATI 

Questa seconda parte tratta principalmente l'u- 
tilizzo di Jython per memorizzare o interagire 
con i dati. 

Questo approccio risulta particolarmente uti- 
le per accedere direttamente ai dati, per modi- 
ficarli o per verificarne la consistenza. Fino ad 
ora si è cercato di non nominare la parola da- 
tabase perché sarebbe limitante nei confronti 
delle potenzialità che offre il linguaggio. Infat- 
ti, Jython, permette la gestione dei dati sia con 
i classici database che su file. 
Il prossimo esempio parla proprio di questa se- 
conda possibilità, mentre gli altri sfrutteranno 
l'accesso ai db. Vedremo come anche in questo 
caso esistano soluzioni sufficientemente ele- 
ganti e semplici da realizzare 



MEMORIZZAZIONE 
SU FILE 

Se l'applicazione che dobbiamo fare deve tene- 
re in memoria pochi dati e se non servono ri- 
cerche particolarmente complesse, si può pen- 
sare di utilizzare i file DBM per scrivere i valori 
di interesse. Usare questi file è molto semplice 
con Jython e il prossimo esempio lo dimostra. 



# File: dbm.py 


import dumbdbm 


dbm = dumbdbm 


open("dbmtest") 


dbm['Value 1'] = 


'A' 




dbm['Value 2'] = 


'B' 




dbm['Value 3'] = 


'B' 




for key in dbm.keysQ: 


print key, ":", 


dbm 


[key] 



Con poche istruzioni si memorizzano su file i 
valori. Il file DBM è simile a un dizionario che con- 
tiene le coppie chiave-valore. 
Fisicamente, si può verificare che, nel file sy- 
stem, sono creati due file uno .dir e uno .dat 
con lo stesso nome del file dichiarato nel codi- 
ce. 

Quindi, per operazioni elementari è assai effi- 
cace questo metodo, mentre per operazioni più 
complesse ci si deve appoggiare ai database. In 
realtà in questo primo caso abbiamo notato 
quanto trasparente allo sviluppatore sia l'inte- 
ra gestione delle operazoni di scrittura e let- 
tura dei dati sull'hard disk. 
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GESTIAMO I DATABASE 

Più frequentemente le applicazioni memoriz- 
zano i dati su database e Jython si può connet- 
tere ai db usando Java. Negli esempi seguenti 
si userà MySQL e la connessione jdbc.odbc co- 
me ponte per accedervi. Ovviamente queste 
scelte si possono adattare ai singoli casi, cam- 
biando il database o l'uri di connessione. Nel 
nostro caso, scegliere questo driver vuol dire 
rendere il codice facilmente utilizzabile anche 
per altri database. Il primo esempio è davvero 
minimale per consentire di capire gli aspetti più 
importanti di una connessione. 

# File: db.py 

import com.ziclix. python. sql as sql 

// uri di connessione 

dburl, user, pw, drv = ("jdbc:odbc:iop","root", 

"password", "su n.jdbc.odbc.JdbcOdbcDri ver") 



// esecuzione query 



db = sql.zxJDBC.connect(dburl, user, pw, drv) 



cursor = db.cursorQ 



cursor.execute("SELECT * FROM tab") 



// stampa dei risultati 



for item in cursor.fetchall(): 



print item 

Veramente molto semplice per chi mastica un po' 
di connessioni. Si importa la classe che serve 
per gestire il collegamento al db, si configura 
l'uri di connessione in accordo con i parametri 
impostati, si esegue la query e si stampa il ri- 
sultato. Da notare come tutto ciò sia possibile gra- 
zie a una classe specifica di Jython. Questo file 
serve solo per riscaldarsi e per verificare che le 
connessioni funziono. Gli altri esempi scendo- 
no più nei dettagli e permettono operazioni più 
elaborate. 



SCANSIONE 
DEI RISULTATI 

Uno degli scenari tipici, quando ci si collega a un 
db, è di dover prendere i dati restituiti da una 
query. Nell'esempio precedete, si è visto l'uti- 
lizzo di cursor che serve a scandire gli elemen- 
ti grazie al metodo fetchallQ. Per chi viene, in- 
vece, dal mondo Java, si può trovare più a suo agio 
con ResultSet. 

# File: resultSet.py 

stmt = dbconn. findattr 

(" connection ").createStatement() 

rs = stmt.executeQuery("SELECT * FROM tab") 
while rs.next(): 

print rs.getString(l) 



A parte gli elementi in comune con gli altri esem- 
pi, che non vengono riportati, le altre istruzio- 
ni servono per popolare un ResultSet che viene 
poi scandito. A questo punto spetta a voi sce- 
gliere il modo migliore per connettersi al db. 



ESEMPIO DATABASE 
LEGGIAMO I METADATI 

Una volta padroni delle connessioni, si può ge- 
neralizzare il tutto. Unendo le capacità grafiche 
e di connessione al db, si può creare una inter- 
faccia grafica che permetta di scegliere a quale 
db collegarsi e che ottiene le principali informa- 
zioni relative al db stesso, i metadati. Come si 
può intuire dalla descrizione dell'esempio, è 
possibile dividere il tutto in due file: il primo che 
contiene l'interfaccia grafica e che si occupa del- 
la connessione e il secondo che reperisce i me- 
tadati e li formatta in maniera opportuna. Il co- 
dice del primo file è riportato di seguito. 

# File: DBLoginDialog.py 

class DBLoginDialog(awt.Dialog): 

def login(self, e): 

db = self.DBMS.selectedltem 



uri 



"jdbc:odbc:" + self.Database.text 



try: 



dbcon = sqlZX.zxJDBC.connect(url, 

self.User.text, 
self. Password .text, 

"sun.jdbc.odbc.JdbcOdbcDriver") 



self.dispose() 



self.client(dbcon) 



except sql.SQLException: 



self.showError("Unable to connect to 

database") 

È davvero solo l'applicazione di quanto visto fi- 
no adesso. A parte tutta la parte grafica, che ma- 









1 I 


C( 
Hostname: 
DBMS: 
Port: 

Database: 
User: 
Password: 


imnection 


nforrnation 




localhost 


MySQL 


—3 




3306 




lop 




root 










Login 




Cancel | 



Figura 11: GUI per selezionare il db 
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Figura 12: Metadati del db 

gari può essere adattata in base ai propri gusti, 
l'obiettivo è quello di presentare una scherma- 
ta come quella in figura 1 1 . 
E di leggere i valori per effettuare la connessio- 
ne al db. I dati che l'utente scrive a video sono 
letti, nel codice sopra e usati per creare l'uri di 
connessione. In caso di problemi, viene lancia- 
ta un'eccezione. Se invece la connessione va a 
buon fine, interviene il secondo file che ha il 
compito di interrogare il db e restituirne i me- 
tadati. 

# File: metaData.py 

def gatherMetaInfo(self, dbconn): 

metaData = 

dbconn. findattr (" connection ").getMetaD 

ata() 

dbname = metaData. databaseProductName 
for cmd in self.getCommandsQ: 



try: 



exec("value = metaData. %s()" % 



cmd) 



except: 



value = "Test failed" 



def getCommands(self): 



return ['getCatalogTerm', 

'getMaxBinaryLiteral Length', 
'getMaxCatalogNameLength', 

'getMaxCharLiteral Length', 



Scorrendo il codice, ci sono due metodi che ser- 
vono per prendere i metadati. Il primo prende 
tutte le informazioni, in generale. Il secondo 



specifica esattamente quali elementi del db an- 
dare a considerare: un esempio degli elementi 
considerati è riportato in figura 12. 
Un esempio del genere può essere una buona 
base per realizzare un'interfaccia grafica che 
tenga sotto controllo tutti i db che abbiamo, 
lanciando query specifiche che mostrano l'in- 
cremento dei dati oppure quanti utenti sono 
connessi al db. 



DATABASE: 
STRATIFICAZIONE 

In questi esempi siamo passati da poche istru- 
zioni a più file, aumentando la complessità del 
codice. Per cercare di rendere il progetto sem- 
plice, si può stratificare ulteriormente il lavoro 
inserendo le informazioni della connessione al 
db in un file a parte. Generalmente si è soliti 
chiamare questo file dbexts.ini che va messo 
nel path in cui lanciamo il progetto. 

# File: dbexts.ini 

[JDBC] 

NAME = MYSQLIOP 

URL=JDBC:ODBC:IOP 

USER=ROOT 

PWD = PASSWORD 

Le righe sopra specificano i parametri di con- 
nessione, mentre le istruzioni seguenti servo- 
no per richiamarle. 



# File: dbextCall.py 


from dbexts import dbexts 


mysqlcon = dbexts("mysqliop". 


"dbexts.ini") 



Il grande vantaggio di questo approccio è di 
mettere in unico punto tutte le informazioni re- 
lative al db, senza doverle replicare. 



CONCLUSIONI 

In questo articolo è stato presentato Jython, la 
fusione tra Python e Java, attraverso una serie di 
esempi che ne illustrano le possibilità e i cam- 
pi di applicazione. Con Jython, infatti, diventa 
più semplice realizzare interfacce grafiche che 
rendono più piacevole il lavoro dell'utente e 
collegamenti ai vari database, magari per effet- 
tuare dei test o dei controlli. Inoltre, i diversi 
esempi, permettono di avere una ampia gamma 
di scelta per poter poi personalizzare le proprie 
applicazioni. 

Cristiano Bellucci 
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L'SMS CHE COMANDA 
IL TUO CELLULARE 

IMPARIAMO COME CONFIGURARE UN CELLULARE, SINCRONIZZARE LA RUBRICA DEGLI 
APPUNTAMENTI, AGGIUNGERE UN CONTATTO E MOLTO ALTRO ANCORA SEMPLICEMENTE 
INVIANDOGLI UN BREVE MESSAGGIO DI TESTO DA REMOTO 




in 




REQUISITI 



Conoscenze richieste 



— C#, Visual Studio 2005 



Windows XP, 
ActiveSync 4. ì, 
Microsoft Device 
Emulator, Visual Studio 
2005 



00000 



In questo articolo analizzeremo alcune nuo- 
ve API esposte in Windows Mobile 5 e cree- 
remo una infrastruttura che ci consentirà di 
comandare il nostro dispositivo (sia Smartpho- 
ne sia Pocket PC) attraverso l'invio di messaggi 
SMS formattati opportunamente. Gli utilizzi di 
questo genere di applicazione sono svariati. Ad 
esempio potremmo inviare un SMS ad un cel- 
lulare per configurarlo secondo certe specifiche 
di un provider. Al termine dell'articolo vedremo 
diversi esempi d'uso. 



LA STRUTTURA 
DEI COMANDI 

Prima di addentrarci nello sviluppo del codice 
della nostra applicazione, dobbiamo risolvere 
una questione di carattere teorico, ovvero dob- 
biamo decidere la struttura dei messaggi che vo- 
gliamo utilizzare come comandi. La scelta di una 
buona struttura del comando è fondamentale 
per rendere più agevole la relativa decodifica ed 
esecuzione. Nel presente articolo, la struttura di 
un messaggio di comando sarà: 

<CMD:><ComandoxParametri> 

Dove <CMD:> rappresenta la parola chiave che 
indica che il messaggio è in realtà un comando; 
<Comando> rappresenta una parola apparte- 
nente alla grammatica dei comandi che andre- 
mo a definire più avanti; <Parametri> rappre- 
senta "il resto" del messaggio che verrà (o meglio 
potrà) essere utilizzato dalla nostra applicazio- 
ne. Un esempio di comando che rispetta la strut- 
tura definita è: 

CMD:CONFIGURA http://mio.dominio.it/smartConfigure.xml 

La sua interpretazione è: 

"esegui un comando di configurazione del dispositivo 

scaricando il relativo file dall'indirizzo http:llmio.do- 

minio.it/smartConfigure.xml". 



INFRASTRUTTURA 
DI BASE 

Come ambiente di sviluppo utilizzeremo Microsoft 
Visual Studio 2005; per iniziare dobbiamo creare un nuo- 
vo progetto. Come mostrato in Figura 1 , dalla lista dei 
tipi di progetto, sceglieremo, ad esempio, Windows 
Mobile 5.0 Pocket PC, e tra i tipi di template Device 
Application (1.0) che ci consentirà di sviluppare una 
applicazione basata sulla versione 1.0 del .Net Fra- 
mework. Questa scelta ci permette di utilizzare co- 
munque tutte le funzionalità di cui abbiamo bisogno 
senza però avere la necessità di installare nessun altro 
componente nel dispositivo (nei file a supporto è pos- 
sibile trovare la soluzione utilizzata nel corso dell'ar- 
ticolo). 






j 1 




) »■ --«- 



Fig. 1: Creiamo un nuovo progetto basato su .Net 
Framework 1.0. 



Il primo passo da compiere nello sviluppo della nostra 
soluzione, è quello di aggiungere un riferimento alle 
dll che contengono le funzionalità che utilizzeremo 
nel seguito della trattazione. Dal pannello della solu- 
zione facciamo clic con tasto destro sulla voce Ri- 
ferimenti, quindi facciamo clic con il tasto sinistro su 
Aggiungi Riferimento. Il dialogo che ci appare mostra 
la lista delle dll disponibili. 

Le nuove classi che andremo ad usare sono contenu- 
te in Microsoft.WindowsMobile.Configuration ed in 
Microsoft.WindowsMobile.PocketOutlook, quindi se- 
lezioniamo le voci dalla lista e premiamo Ok (si veda 
Figura 2). Una volta fissato il riferimento alle dll, nel 
codice aggiungiamo delle clausole usingm modo da 
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Microsoft. VisualBasic 


7.0.5000,0 vi, 1.4322 
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Microsoft. WincìowsCE.Forrns 


1,0,5000,0 vi, 1.4322 


C:\Prograrn 




Microsoft. WindowsMobile 


1.0.0,0 vi, 1.4322 


C:\Prograrn 




Microsoft. WincìowsMobile.Forrns 


1.0.0,0 vi? 1.4322 


C:\Prograrn 
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System 
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System. Data. SqlServerCe 
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System. Drawing 
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C;\Prograrn v 
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Fig. 2: Aggiungiamo i riferimenti alle dll che contengono 
le nuove classi. 



poter utilizzare le classi dichiarando semplicemente 
il loro nome senza dover ogni volta specificare il na- 
mespace di appartenenza. 

using Microsoft. WindowsMobile.Configuration; 
using Microsoft. WindowsMobile.PocketOutlook; 
using Microsoft. WindowsMobile.PocketOutlook 

. Messagelnterception ; 

Per inizializzare il processo di intercettazione, defi- 
niamo un metodo privato che viene invocato all'avvio 
dell'applicazione (InitializelnterceptorO). 
Nella prima parte del metodo carichiamo un oggetto 
di tipo XmlDocument con un frammento XML che 
contiene alcuni valori di configurazione che utilizze- 
remo in seguito. Il documento XML di configurazio- 
ne ha lo stesso nome dell'eseguibile ed è memoriz- 
zato nella stessa cartella. 

// Creiamo il documento che conterrà i valori di 

// configurazione 

oXDoc = new XmlDocument(); 

// Individuiamo il percorso del file di configurazione 

fullyQualifiedName = (System. Reflection.Assembly. 

GetExecutingAssembly().GetModules())[0]. 
FullyQualifiedName; 
string configPath = fullyQualifiedName. Replace( 

".exe", ".xml"); 
try 
{ // Carichiamo il documento con la configurazione 

oXDoc.Load(configPath); } 
catch (XmlException xExc) 
{ IblError.Text = xExc.Message; } 



chiamo, invece, il valore NotifyAndDelete, il messag- 
gio non verrà notificato e nemmeno memorizzato. 
In questo secondo scenario il dispositivo reagirà in 
modo attivo ai comandi senza interferire nelle atti- 
vità dell'utente; se da una parte questo comporta- 
mento è ideale per comandi di configurazione o per 
interagire con Pocket Outlook, dall'altra è necessario 
che l'utente sia consapevole di avere un dispositivo 
"attivo" in modo da non disorientarsi al vedere nuo- 
vi appuntamenti o nuove configurazioni attivate in 
modo "silente". Nell'esempio che utilizzeremo nel cor- 
so della trattazione si è scelto di notificare i messaggi 
in modo da avere anche una traccia del comporta- 
mento del sistema. 

// Definiamo la sorte dei messaggi di comando che NON 
// saranno cancellati 

InterceptionAction oIAction = InterceptionAction.Notify; 
// Creiamo un nuovo oggetto di tipo Messagelnterceptor 
oSmsInterceptor = new MessageInterceptor( 

oIAction, true); 

Al fine di ottimizzare la procedura di intercettazione 
e, soprattutto, al fine di intercettare solo quei mes- 
saggi che corrispondono a comandi, è possibile de- 
finire una "condizione", il cui verificarsi comporta 
riconoscimento del messaggio come comando. 
L'irifrastruttura messa a disposizione da Windows Mo- 
bile 5, ci consente innanzitutto di decidere in che "par- 
te" del messaggio andare a verificare la condizione; 
attraverso l'enumeratore MessageProperty possiamo 
selezionare ad esempio corpo del messaggio oppu- 
re il mandante. Nel caso sotto esame abbiamo defi- 
nito che il comando è contenuto nel corpo del mes- 
saggio. 

MessageProperty oMProperty = MessageProperty.Body; 

Dopo aver individuato in che parte del messaggio ef- 
fettuare la verifica della condizione, dobbiamo definire 
che tipo verifica intendiamo fare; attraverso l'enu- 
meratore MessagePropertyComparisonType possia- 
mo decidere se la condizione è verificata quando la 
proprietà scelta (il corpo del messaggio) "comincia 
per" oppure "finisce per" oppure "contiene" una da- 
ta stringa. Nel nostro caso decidiamo che il messag- 
gio è un comando quando "comincia per" una strin- 
ga che definiremo in fase di definizione della condi- 
zione. 





Una estesa trattazione 
("da una prospettiva 
da sviluppatore") su 
tutte le novità del nuo- 
vo sistema operativo 
Windows Mobile 5, è 
reperibile nella Library 
MSDN nell'articolo: 
• WHAT'S NEW FOR 
DEVELOPERS IN 
WINDOWS MOBILE 5.0 
a partire dall'indirizzo: 
http://msd n2 . m icrosoft. 
com/en-us/librarv 
/ms839548.aspx 



L'infrastruttura di intercettazione si basa sulla classe 
Messagelnterceptor; il costruttore che utilizzeremo 
prende in input due parametri. Il primo indica cosa fa- 
re del messaggio intercettato; le azioni possibili sono 
due e vengono definite attraverso l'enumeratore In- 
terceptionAction. Se specifichiamo come valore No- 
tify, il messaggio intercettato viene notificato all'u- 
tente e conservato come qualsiasi altro; se specifi- 



MessagePropertyComparisonType oMPComparition = 

MessagePropertyComparisonType. Sta rtsWith; 

Definite le diverse parti della condizione pos- 
siamo valorizzare la proprietà MessageCondi- 
tion del nostro oggetto Messagelnterceptor al fi- 
ne di consentire la corretta intercettazione dei 
messaggi: 
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oSmsInterceptor.MessageCondition = 

new MessageCondition(oMProperty, 
oMPComparition, "CMD:", true); 

Da quanto detto in precedenza, la condizione va let- 
ta in questo modo: "Intercetta tutti quei messaggi il 
cui corpo inizia per CMD:"; l'ultimo parametro, va- 
lorizzato a true ci consente di impone che la condizione 
sia anche sensibile alle maiuscole ("case sensitive"). 
Come ultima istruzione, dobbiamo aggiungere un ge- 
store dell'evento che reagisca all'intercettazione di 
un messaggio di comando; ciò si attua valorizzando la 
proprietà MessageReceived del nostro oggetto Messa- 
gelnterceptor. 

oSmsInterceptor. MessageReceived += new 

MessageInterceptorEventHandler( 
smsInterceptor_MessageReceived); 

Di seguito il codice completo del metodo Initiali- 
zelnterceptorO- 

private void InitializeInterceptor() 
{ // Creiamo il documento che conterrà i valori di 
// configurazione 
oXDoc = new XmlDocument(); 
// Individuiamo il percorso del file di configurazione 
fullyQualifiedName = (System. Reflection.Assembly. 
GetExecutingAssembly().GetModules())[0] 

.FullyQualifiedName; 
string configPath = fullyQualifiedName.Replace( 

".exe", ".xml"); 

try 

{ // Carichiamo il documento con la configurazione 

oXDoc.Load(configPath); } 
catch (XmlException xExc) 
{ IblError.Text = xExc.Message;} 

try 

{ // Definiamo la sorte dei messaggi di comando che 
// NON saranno cancellati 

InterceptionAction oIAction = InterceptionAction.Notify; 
// Creiamo un nuovo oggetto di tipo Messagelnterceptor 



oSmsInterceptor = 



new MessageInterceptor( 

oIAction, true); 



// Definiamo su che campo deve essere verificata la 



// condizione 



MessageProperty oMProperty = MessageProperty.Body; 

// Definiamo il tipo di confronto della condizione 

MessagePropertyComparisonType oMPComparition = 

MessagePropertyCompahsonType.StartsWith; 

// Definiamo la condizione affinchè un messaggio sia 



// riconosciuto come comando 



oSmsInterceptor. MessageCondition = new 

MessageCondition(oMProperty, oMPComparition, 

"CMD:", true); 
// Aggiungiamo un gestore dei messaggi riconosciuti 



// come comandi 



oSmsInterceptor. MessageReceived + = 



new MessageInterceptorEventHandler( 

smsInterceptor_MessageReceived); } 
catch (Exception exc) 
{ IblError.Text += exc.Message;} 



IL PARSER DEI COMANDI 

Una volta definita l'infrastruttura di base della nostra 
applicazione, dobbiamo implementare il gestore del- 
l'evento che reagisce all'intercettazione di un mes- 
saggio di comando. Come possiamo immaginare, 
questo metodo non è nient' altro che un parser (o ana- 
lizzatore sintattico) dei comandi che, a partire dalla 
grammatica definita all'inizio della trattazione, deve 
interpretare ed eseguire il comando contenuto nel 
messaggio. La sua implementazione comincia con la 
cattura del messaggio ricevuto: 

// Istanziamo un oggetto "SMS" con il messaggio intercettato 
SmsMessage sms = (SmsMessage)e.Message; 

Quindi dobbiamo isolare il corpo del messaggio, eliminare 
la parte iniziale che contiene solo la parola chiave 
{"CMD:'), infine isolare il comando da eseguire. 



// Isoliamo il contenuto del messaggio 

string smsBody = sms. Body; 

// Eliminiamo la parte iniziale del messaggio ("CMD:") 

string message = smsBody.Substring(4); 

int commandLen = message. IndexOf(' '); 

// Isoliamo il comando specifico (<ComandoxParametri>) 

string command = message. Substring(0, commandLen); 



L'ultima parte del metodo è un semplice "switch" che, 
sulla base del comando individuato, esegue il relativo 
codice di attuazione. 

private void smsInterceptor_MessageReceived( 

object sender, MessagelnterceptorEventArgs e) 
{ // Istanziamo un oggetto "SMS" con il messaggio 
// intercettato 

SmsMessage sms = (SmsMessage)e. Message; 
// Isoliamo il contenuto del messaggio 
string smsBody = sms. Body; 

// Eliminiamo la parte iniziale del messaggio ("CMD:") 
string message = smsBody.Substring(4); 
int commandLen = message. IndexOf(' '); 
// Isoliamo il comando specifico (<ComandoxParametri>) 
string command = message. Substring(0, commandLen); 
// Individuiamo il comando da eseguire 
switch (command) 
{ case "CIRCOLA": 

// Gestione Messaggi Circolari 
sendCircularMessage(message); 
break; 
case "CONFIGURA": 
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// Gestione Configurazione Remota 



getConfiguration(message.Substring(9)); 



break; 



case "OUTLOOK" 



// Gestione Pocket Outlook 



manageOutlook(message.Substring(7)); 



break; } 



} 



Nel seguito della trattazione verranno definiti tre esem- 
pi che dimostrano come mettere in pratica l'inter- 
cettazione dei messaggi SMS. Vedremo come sia pos- 
sibile far sì che il dispositivo venga configurato re- 
motamente attraverso lo scarico di un file di confi- 
gurazione; inoltre vedremo come implementare una 
struttura di messaggistica "a catena"; infine vedremo 
come interagire con il nuovo Pocket Outlook. 



CONFIGURAZIONE 
REMOTA 

L'intercettazione di messaggi SMS, può esserci di gran- 
de aiuto nella configurazione di dispositivi remoti. 
Per implementare questa soluzione, utilizzeremo il 
provisioning via XML, ovvero la capacità di configu- 
rare i dispositivi mobili basati su Windows Mobile tra- 
mite documenti XML. In un precedente articolo è sta- 
to dettagliatamente trattato l'argomento del provi- 
sioning via XML, quindi, in questa sede, ci basterà sa- 
pere che, al fine di consentire la configurazione re- 
mota, dobbiamo attivare un server web in modo che 
possa ospitare il documento XML di configurazione e 
far sì che questo sia raggiungibile dal nostro disposi- 
tivo. Nell'esempio che stiamo considerando, nella no- 
stra macchina di sviluppo sarà attivato anche Internet 
Information Server in cui definiremo una cartella vir- 
tuale al cui interno andremo a memorizzare il nostro 
documento di configurazione. La struttura del messaggio 
SMS che dovremo inviare al dispositivo, ricordando an- 
che la grammatica definita in precedenza, sarà: 

CMD:CONFIGURA <URL Documento di configurazione> 

Dove <URL Documento di configurazione> rap- 
presenta l'indirizzo a cui dovremo connetterci per 
scaricare il documento di configurazione. 
Se analizziamo il codice di esecuzione del comando 
(getConfigurationO), come prima cosa dobbiamo 
effettuare una richiesta al server web il cui indi- 
rizzo ci viene passato in input; utilizziamo il metodo 
CreateO della classe WebRequest passando come pa- 
rametro l'indirizzo del documento di configura- 
zione. 

// Effettuiamo una richiesta al server il cui indirizzo 

// ci viene passato in input 

WebRequest oRequest = WebRequest.Create(requestURL); 



Dopodiché dobbiamo analizzare la risposta del server 
attraverso un oggetto di tipo WebResponse che creia- 
mo invocando il metodo GetResponseO dell'oggetto 
di tipo WebRequest appena creato. 

// Gestiamo la risposta del server 

WebResponse oResponse = oRequest. GetResponseO; 

Per leggere i dati inviati dal server in risposta alla no- 
stra richiesta, prima dobbiamo "canalizzarli" in un 
flusso (.Stream), quindi li andremo a leggere con un 
oggetto di tipo StreamReader (dopo aver definito op- 
portunamente il tipo di codifica da utilizzare) . 

// Canalizziamo la risposta del server su di uno stream 
Stream oResponseStream = oResponse. 

GetResponseStreamQ; 
// Definiamo la giusta codifica per la lettura dello stream 
Encoding oEncode = System.Text. Encoding. 

GetEncoding("utf-8"); 
// Creiamo un "lettore" dello stream 
StreamReader oStreamReader = new 

StreamReader(oResponseStream, oEncode); 

Per poter utilizzare i dati li "scarichiamo" su di una 
stringa utilizzando il metodo ReadToEndQ dell'og- 
getto di tipo StreamReader. 

Il Scarichiamo il contenuto dello stream in una stringa 
sConfigDoc = oStreamReader.ReadToEnd(); 

A questo punto, se tutte le operazioni sono andate a buon 
fine, la stringa sConfigDoc contiene esattamente il do- 
cumento XML che dobbiamo utilizzare per configu- 
rare il dispositivo. Dopo aver opportunamente chiu- 
so tutti i flussi, possiamo caricare il documento rice- 
vuto, in un oggetto di tipo XmlDocument invocando 
il metodo LoadXmlO- 

Il Creiamo un nuovo oggetto "Documento XML" 
XmlDocument xConfigDoc = new XmlDocument(); 
// Istanziamo il nuovo oggetto con il documento 
// da utilizzare per la configurazione 
xConfigDoc.LoadXml(sConfigDoc); 



Come ultima operazione non ci resta che invocare il 
Confìguration Manager che si occupa di applicare le 
configurazioni che gli vengono fornite attraverso il 
documento XML di configurazione. Il Confìguration 
Manager è implementato dalla classe Configuration- 
Manager che è anch'essa parte delle nuove funzio- 
nalità messe a disposizione da Windows Mobile 5; per 
poter utilizzare tale classe abbiamo già aggiunto un 
riferimento all'assembly che la contiene ovvero Mi- 
crosoft.WindowsMobile.Configuration ed abbiamo 
anche aggiunto una clausola using all' omonimo na- 
mespace in modo da poter utilizzare direttamente la 
classe senza dover specificare per intero la struttura del 




GESTIRE 
GLI ERRORI 

Durante il debug delle 
nostre applicazioni per 
dispositivi mobili, può 
capitare inevitabil- 
mente di incappare in 
errori non "frappati" 
correttamente che 
danno luogo ad ecce- 
zioni. Se ci capita di ve- 
dere lo strano messag- 
gio "Could not f ind re- 
source assembly" non 
dobbiamo allarmarci; 
per motivi di spazio 
(siamo in dispositivi 
mobili ancora abba- 
stanza limitati) i file 
che contengono i mes- 
saggi di errore "par- 
lanti" non sempre ven- 
gono caricati nel di- 
spositivo. Per ovviare 
a tale problema è sem- 
plicemente necessario 
copiare ed installare 
nel dispositivo il file 
System SRIT.cab che 
contiene i suddetti 
messaggi (dopo l'in- 
stallazione è necessa- 
rio il restart del dispo- 
sitivo). Un interessante 
articolo sull'argomen- 
to è reperibile all'indi- 
rizzo: 

http://blogs.msdn.com 
/netcftea m/a rch i ve/2004 
/08/06/210232.aspx 
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DOVE 

TROVARE 

L'EMULATORE! 

Microsoft Device Emù- 
lator è compreso in Mi- 
crosoft Visual Studio 
2005 oppure è possibi- 
le scaricarlo dal sito 
Microsoft a partire dal- 
l'indirizzo 
http://msdn.microsoft,com 
Anobi lity/windowsmobile 
/downloads/defaultaspx 
dove è possibile scari- 
care anche l'SDK di 
Windows Mobile 5.0 
per Pocket PC e per 
Smartphone; questo 
componente aggiunge 
gli emulatori per la 
piattaforma Windows 
Mobile 5.0 al Device 
Emulator. 



namespace. L'applicazione della configurazione av- 
viene invocando il metodo statico ProcessConfigura- 
tion della classe ConfigiiratìonManager; questo, pren- 
de in input proprio l'oggetto XmlDocument che abbiamo 
appena creato (xConfigDoc); come secondo parame- 
tro di input prende un valore booleano che, se impo- 
stato a true, comporta la restituzione del documento 
stesso con l'aggiunta di tag opportuni per evidenzia- 
re gli eventuali errori riscontrati nel processo. 

// Inviamo il documento di configurazione al Configuration 
// Manager 
ConfigurationManager.ProcessConfiguration( 

xConfigDoc, false); 

In breve, quindi, la configurazione del nostro dispo- 
sitivo (che potrebbe essere anche molto complessa) si 
attua con una sola linea di codice. Questa precisazio- 
ne è importante per sottolineare ancora una volta la 
potenza delle primitive messe a disposizione da Win- 
dows Mobile 5. Ovviamente, dato che praticamente ognu- 
na delle istruzioni descritte può causare un errore (ad 
esempio l'indirizzo può essere errato oppure può non 
essere raggiungibile), è buona norma racchiudere il 
codice appena visto in una istruzione try che ci con- 
sente di "trappare" eventuali errori e quindi mostra- 
re un messaggio intelligibile all'utente (che magari se 
ne farà ben poco ma quantomeno potrà comunicar- 
celo consentendoci di correggere o almeno spiegare 
il malfunzionamento) . Di seguito il codice di esecuzione 
del comando getConflgurationO- 

private void getConfiguration(string requestURL) { 
string sConfigDoc = ""; 
try{ 

// Effettuiamo una richiesta al server il cui indirizzo 

// ci viene passato in input 

WebRequest oRequest = WebRequest.Create( 

requestURL); 

// Gestiamo la risposta del server 

WebResponse oResponse = oRequest.GetResponse(); 

// Canalizziamo la risposta del server su di uno stream 



Stream oResponseStream : 



oResponse. 
GetResponseStreamQ; 



// Definiamo la giusta codifica per la lettura dello stream 
Encoding oEncode = System.Text. Encoding. 

GetEncoding("utf-8"); 
// Creiamo un "lettore" dello stream 
StreamReader oStreamReader = new StreamReader( 
oResponseStream, oEncode); 
// Scarichiamo il contenuto dello stream in una stringa 
sConfigDoc = oStreamReader.ReadToEndQ; 
// Chiudiamo tutti i flussi 
oStreamReader.Closef,); 
oResponseStream. CloseQ; 
oResponse. Close(); 

// Creiamo un nuovo oggetto "Documento XML" 
XmlDocument xConfigDoc = new XmlDocument(); 



// Istanziamo il nuovo oggetto con il documento 

// da utilizzare per la configurazione 

xConfigDoc.LoadXml(sConfigDoc); 

// Inviamo il documento di configurazione al 



// Configuration Manager 



ConfigurationManager.ProcessConfiguration( 

xConfigDoc, false); } 



catch (Exception ex) { 



IblError.Text = ex.Message;} 



} 



Per verificare il comando di configurazione remota 
utilizziamo Microsoft Device Emulator che emula di- 
spositivi basati su Windows Mobile 5. Utilizzeremo 
altresì il numero 14250010001 che consente di invia- 
re messaggi all'emulatore stesso. La Figura 3 mostra 
uno storyboard in cui sono raffigurate le fasi attra- 
verso cui possiamo verificare il funzionamento della 
nostra applicazione quando viene inviato un mes- 
saggio di comando di configurazione remota. Nel te- 
st utilizziamo il file di configurazione smartConfigu- 
re.xml che possiamo trovare nei file di supporto e che 
effettua l'aggiunta di due preferiti a Pocket Internet 
Explorer. Si presuppone che sulla macchina di test ci 
sia attivo Microsoft Internet Information Server con una 
directory virtuale dove viene ospitato il file di confi- 
gurazione. Il messaggio che inviamo al dispositivo è il 
seguente: 

CMD:CONFIGURA http://10. 6.97. 127 

/XMLProvisioning/smartConfigure.xml 

Se proviamo a descrivere i diversi passi: 

A. Innanzitutto verifichiamo lo stato attuale dei 
preferiti di Pocket Internet Explorer; 

B. Compiliamo il messaggio che indica alla applica- 
zioni di scaricare il file di configurazione da un 
dato indirizzo (per effettuare test sulla propria 
macchina è necessario modificare l'indirizzo IP 
con quello della propria macchina); alla fine 
della compilazione premiamo Send per inviare il 



\ Internet Explorer +* ^III Hs ok I Text Messages +? 7i| H|^ ok . 



From: (Text Messages) 
To: 14250010001 



,? 



V MSN Mobile 
^ Pocket PC Web Guide 
Sf Windows Mobile 
© WindowsMedia.com 



CMDìt SFIGURA 

http://10.6.97.127/XMLProvisioninq/srn.3rr.C 

onFiqure.xrnl 

67/16D 



Tpuiu-J 



[m! +7 Til H~ X _ Internet Explorer |^| +!r Til ^- ok 



^ 14250010001 4:18 PM lt 

CMD:CONFIGURA http:// 10.6.97... 



14250010001 2/19/07 



SÌ MSN Mobile 
(."* Pocket PC Web Guide 
V Windows Mobile 
© WindowsMedia.com 

Your Favorite 

Your Second Favorite 




Fig. 3: Configurazione remota tramite invio 
di messaggio SMS. 
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messaggio; 

G II messaggio è ricevuto correttamente; dato che 
l'applicazione è configurata per notificare anche 
i messaggi di comando, questo viene mostrato 
come qualsiasi altro messaggio; 

D. Verifichiamo che i preferiti di Pocket Internet Ex- 
plorer sono variati così come da file di configura- 
zione. 



INTERAZIONE 
COni MICROSOFT 
POCKET OUTLOOK 

Le grandi organizzazioni che possono permettersi 
una infrastruttura di messaggistica basata su Micro- 
soft Exchange, possono sfruttare le possibilità di sin- 
cronizzazione via etere dei dispositivi mobili. Con ta- 
le caratteristica, tutti i dispositivi mobili aziendali han- 
no la capacità di sincronizzare i contatti, l'agenda, le 
attività e la posta elettronica con il server Exchange. 
Indubbiamente l'investimento necessario per instal- 
lare una infrastruttura basata su Exchange non è con- 
cepibile per le piccole organizzazioni e tanto meno 
per singoli professionisti. Di seguito vedremo come 
le nuove primitive messe a disposizione da Windows 
Mobile 5 ci consentano di sincronizzare alcune infor- 
mazioni via etere riproducendo, in parte, il meccani- 
smo implementato con Microsoft Exchange. 
Innanzitutto dobbiamo stabilire la grammatica del 
nuovo comando. In questo caso possiamo immagi- 
nare di strutturare il comando su più livelli nel senso 
che un primo livello ci consentirà di capire che il mes- 
saggio di comando intende interagire con Microsoft 
Pocket Outlook; un secondo livello ci consentirà di 
specificare più dettagliatamente che tipo di intera- 
zione si intende eseguire (gestione di un appunta- 
mento, piuttosto che di un contatto) ; un terzo livello, 
infine, ci consentirà di specificare se l'operazione da 
fare è una aggiunta o una cancellazione. 
In questo articolo vedremo come gestire le interazio- 
ni con gli appuntamenti, i contatti e le attività. 
La struttura del messaggio sarà: 

CMD:OUTLOOK <Destinazione><AddOrDelxParametri> 

Dove <Destinazione> può assumere uno tra i seguenti 
valori: APP per gestire gli appuntamenti; CON per ge- 
stire i contatti; rSKTper gestire le attività. <AddOrDel> 
può assumere uno tra i seguenti valori: ADD per ef- 
fettuare l'aggiunta di un elemento; DEL per effettua- 
re una cancellazione. <Parametri> sarà una lista se- 
parata dal carattere "pipe" (\), contenente le infor- 
mazioni necessarie per gestire l'informazione relati- 
va. Se analizziamo il codice di esecuzione del comando 
(manageOutlookO), come prima cosa dobbiamo sta- 
bilire una connessione con Pocket Outlook ovvero 
apriamo una sessione: 



// Apriamo una sessione con Pocket Outlook 
OutlookSession oOSession = new OutlookSession() 

Quindi dobbiamo analizzare il contenuto del co- 
mando, cominciando ad isolare secondo livello che 
ci indica l'ambito su cui agire (appuntamenti, con- 
tatti o attività). 



// Isoliamo il comando di II livello 

string subCommand = command.Substring(l, 3); 

Infine immagazziniamo i parametri (compreso il tipo 
di comando da eseguire) in un array. 



// Isoliamo i paramentri in un Array 

string[] arrParameters = command.Substring(5) 

.Split(new char[] { T }); 

Analizzando, attraverso uno statement switch, il con- 
tenuto del comando di secondo livello possiamo at- 
tivare il processo nel relativo ambito. 

switch (subCommand) { 
case "APP": 

// Gestione Appuntamenti 

manageAppointment(arrParameters, oOSession); 

break; 
case "CON": 

// Gestione Contatti 

manageContact(arrParameters, oOSession); 

break; 
case "TSK": 

// Gestione Attività 

manageTask(arrParameters, oOSession); 

break; 
} 



Per facilitare la gestione andremo ad incapsulare in 
altrettanti metodi la gestione degli appuntamenti, dei 
contatti e delle attività. 



GESTIONE 

DEGLI APPUNTAMENTI 

Attraverso il metodo manageAppointmentO gestia- 
mo gli appuntamenti che sono implementati dalla 
classe Appointment contenuta nel namespace Mi- 
crosoft. WindowsMobile.PocketOutlook. Creiamo quin- 
di un oggetto di tipo Appointment. 

Il Creiamo il nuovo oggetto "Appuntamento" 
Appointment oAppointment = new Appointment(); 

Di seguito dobbiamo valorizzare le diverse proprietà 
dell'oggetto con i valori dei parametri che ci arrivano 
in input. La classe Appointment è veramente ricca ed 
esistono numerose proprietà che possono essere va- 
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lorizzate. Nel contesto attuale ci basterà definire un 
appuntamento specificando solamente l'argomento 
(Subject), la data di inizio (Start) e la data di fine (End), 
che sono gli elementi minimali per la sua definizione. 

// Istanziamo i valori 

oAppointment.Subject = arrParameters[l]; 
oAppointment.Start = buildDateTime(arrParameters[2]); 
oAppointment.End = buildDateTime(arrParameters[3]); 



Chiaramente, passando un numero diverso di infor- 
mazioni sarà possibile gestire qualsiasi aspetto del- 
l'appuntamento. 

Possiamo notare che la proprietà Subject è di tipo 
stringa quindi può essere inizializzata direttamente 
con il valore del parametro di input; le proprietà Start 
ed End, invece, essendo di tipo DateTime, devono es- 
sere inizializzate con un valore opportunamente de- 
finito utilizzando la funzione illustrata di seguito: 

private DateTime buildDateTime(string sDateTime) { 
// Separiamo la data dall'ora 

string[] arrDateTime = sDateTime.Split(new char[] {''}); 
// Isoliamo le componenti della data 
string[] arrDate = arrDateTime[0].Split(new char[] { '/' }); 
// Isoliamo le componenti dell'orario 
string[] arrTime = arrDateTime[l].Split(new char[] 

{':'}); 

// Creiamo un nuovo oggetto di tipo DateTime con le 

// componenti 

DateTime oDateTime = new DateTime( 

Convert.ToInt32(arrDate[2]), 

Convert.ToInt32(arrDate[l]), 

Convert.ToInt32(arrDate[0]), 

Convert.ToInt32(arrTime[0]), 

Convert.ToInt32(arrTime[l]), 

Convert.ToInt32(arrTime[2])); 
return oDateTime; 
} 



La funzione attende in input una stringa con il for- 
mato "gg/mm/aaaa hh:mm:ss"; dopo aver opportu- 
namente isolato le varie componenti della data e del- 
l'orario non fa altro che creare un opportuna istanza 
della classe DateTime passando le singole compo- 
nenti. Tornando alla gestione degli appuntamenti, 
una volta definito l'oggetto di tipo Appointment, dob- 
biamo analizzare il valore del comando di terzo livel- 
lo che ci indica se effettuare una aggiunta od una can- 
cellazione. Nel primo caso dobbiamo solo aggiunge- 
re l'appuntamento appena creato alla relativa lista; 
utilizziamo il metodo Add() della collezione Items 
esposta dalla collezione Appointments della sessione 
Pocket Outlook, aperta in testa al metodo di gestione 
del comando e passata come parametro (oOSession). 

Il Aggiungiamo il nuovo appuntamento 

oOSession. Appointments. Items. Add(oAppointment); 



Nel caso in cui dovessimo invece cancellare un ap- 
puntamento, dobbiamo utilizzare una procedura me- 
no immediata. Tra le diverse possibilità, la più flessi- 
bile è offerta dal metodo RestrictO sempre della collezione 
Items usata in precedenza. Il metodo consente di se- 
lezionare un sottoinsieme di elementi della collezio- 
ne, a partire da una stringa che definisce il criterio di 
selezione; la stringa deve contenere una espressione, 
di tipo booleano, che viene valutata per ogni elemento 
della collezione; i nomi delle proprietà da utilizzare 
nella selezione devono essere racchiusi tra parentesi 
quadre ([]) mentre i valori testuali da usare nei con- 
fronti, devono essere racchiusi tra doppi apici (""); è 
possibile combinare diverse espressioni con opera- 
tori AND ed OR. Nel caso che stiamo analizzando uti- 
lizzeremo tutte le proprietà che ci arrivano dal messaggio 
SMS, ovvero l'argomento (Subject) e le date di inizio e 
fine dell'appuntamento (Start, End). 

Il Ricerchiamo l'appuntamento da cancellare 
AppointmentCollection oACollection = 
oOSession. Appointments. Items. Restrict( 

"[Subject] = \"" + arrParameters[l] + 
"\" AND [Start] = " + buildDateTime( 
arrParameters[2]).ToString() + 
" AND [End] = " + buildDateTime( 

arrParameters[3]).ToString()); 

Possiamo notare come i valori delle date NON deb- 
bano essere messi tra apici dato che non rappresen- 
tano valori stringa. È solo il caso di evidenziare che 
l'utilizzo di questo metodo potrebbe essere utilizzato 
in maniera ulteriormente flessibile per operare in mo- 
do massivo su insiemi di appuntamenti. È altresì in- 
teressante notare che, indipendentemente dalle pro- 
prietà che possono essere gestite "in effettivo", la strin- 
ga di selezione necessaria per l'individuazione di un 
appuntamento può essere composta solo da quelle 
proprietà che individuano univocamente un appun- 
tamento; possiamo quindi affermare con tranquillità 
che la stringa utilizzata nel presente articolo può an- 
dar bene anche in una situazione in cui le informa- 
zioni passate via SMS siano più numerose. 
Il risultato della selezione è memorizzato in una col- 
lezione di appuntamenti (oACollection) che dovremo 
scorrere per cancellare ogni elemento. 

foreach (Appointment oApp in oACollection) { 
// Cancelliamo l'appuntamento 



oOSession. Appointments. Items. Remove(oApp); 



} 



break; 

La cancellazione dell'appuntamento avviene invo- 
cando il metodo RemoveO della solita collezione Items. 
Di seguito il codice del metodo. 

private void manageAppointment(string[] arrParameters, 
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OutlookSession oOSession) 



try 



{ 



// Creiamo il nuovo oggetto "Appuntamento" 
Appointment oAppointment = new Appointment(); 
// Istanziamo i valori 

oAppointment. Subject = arrParameters[l]; 
oAppointment. Start = buildDateTime( 

arrParameters[2]); 



oAppointment. End : 



buildDateTime( 

arrParameters[3]); 



// Decidiamo l'operazione da compiere 



switch (arrParameters[0]){ 



case "ADD" 



// Aggiungiamo il nuovo appuntamento 
oOSession.Appointments.Items.Add( 

oAppointment); 
break; 
case "DEL": 
// Ricerchiamo l'appuntamento da cancellare 
AppointmentCollection oACollection = 
oOSession.Appointments.Items.Resthct( 

"[Subject] = \"" + arrParameters[l] + 

"\" AND [Start] = " + buildDateTime( 

arrParameters[2]).ToString() + 

" AND [End] = " + buildDateTime( 

arrParameters[3]).ToString()); 

foreach (Appointment oApp in oACollection) 

3 

// Cancelliamo l'appuntamento 
oOSession.Appointments.Items.Remove(oApp); 

_J 

break; 




Fig. 5: Definizione di un appuntamento tramite messaggio SMS 

C) Verifichiamo che il messaggio sia arrivato corret- 
tamente; 

D) Verifichiamo che l'appuntamento sia stato effet- 
tivamente aggiunto. 



DISTRIBUZIONE 
DELL'APPLICAZIOME 

A supporto del presente articolo possiamo trova- 
re la soluzione per Visual Studio 2005 che implementa 
l'applicazione di intercettazione dei messaggi SMS. 
Per distribuire l'applicazione innanzitutto dob- 
biamo lanciare la "build" della soluzione che creerà 
l'eseguibile SMSInterceptor.exe. Dopodiché pos- 
siamo tranquillamente copiare l'eseguibile nel di- 
spositivo, in una qualsiasi cartella, per poi lan- 
ciarlo sul dispositivo affinché venga attivata la pro- 
cedura di intercettazione. In fase di distribuzione 
dell'applicazione è necessario ricordarsi di spo- 
stare sul dispositivo, nella stessa cartella dell'ese- 
guibile, anche il documento di configurazione 
chiamato SMSInterceptor.xml che abbiamo usato 
nell'esempio dei messaggi circolari e che è parte del- 
la soluzione. 



} 

catch (Exception ex) 
{IblError.Text = ex.Message;} 

} 



Per verificare il funzionamento dell'applicazio- 
ne relativamente alla gestione degli appunta- 
menti, inviamo al dispositivo il seguente mes- 
saggio: 

CMD:OUTLOOK APP ADD|Appuntamento per discussione 
articolo |22/02/2007 10 : 00: 00 1 22/02/2007 11:00:00 

La sua interpretazione è: "Aggiungere un appunta- 
mento per il 22 Febbraio dalle 10 alle 1 1 del mattino per 
discussione su articolo". 

Se commentiamo lo storyboard di Figura 5 che mo- 
stra l'esempio in pratica: 

A) Verifichiamo che non vi siano appuntamenti nel 
prossimo futuro; 

B) Compiliamo ed inviamo il messaggio in modo che 
sia fissato un appuntamento per il 22 di Febbraio; 



CONCLUSIONI 

Con l'ultimo sistema operativo per dispositivi mo- 
bili, Windows Mobile 5, Microsoft ha ulteriormente 
allargato le funzionalità dedicate agli sviluppato- 
ri in ambito .Net Framework. 
Nel presente articolo abbiamo avuto occasione di 
prendere conoscenza di alcuni aspetti peculiari 
che ci hanno consentito di creare una infrastruttura 
di intercettazione di messaggi SMS attraverso cui 
abbiamo la possibilità di "comandare" il nostro di- 
spositivo basato su Windows Mobile 5. Negli esem- 
pi che abbiamo sviluppato, abbiamo avuto altre- 
sì modo di osservare all'opera altre nuove primitive 
per la gestione della configurazione remota, per 
l'invio di messaggi SMS e per l'interazione con 
Pocket Outlook. Indubbiamente, una volta eretta 
l'infrastruttura di intercettazione, sono pratica- 
mente infinite le possibilità di interrogazione ed 
interazione verso i nostri dispositivi. 

Oscar Peli 
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Molti servizi erogati via Web hanno per varie 
ragioni la necessità di adattare i propri 
contenuti alla "cultura" dell'utente che si 
collega al sito. Si pensi ad esempio ad un sito dedi- 
cato ai cittadini europei che fornisce informazioni 
sui nuovi modelli di autovettura vendute negli stati 
membri della EU e in quale di questi sia più conve- 
niente acquistarle. Ovviamente c'è la necessità di 
fornire i contenuti, come ad esempio le descrizione 
degli interni degli autoveicoli, in varie lingue: per l'u- 
tente che si collega dalla Germania in tedesco, per 
un belga in francese. Il prezzo dell'automobile dovrà 
essere mostrato nella moneta utilizzata nel Paese 
d'origine dell'internauta, quindi tutti gli utenti pro- 
venienti dall'area euro vedranno il prezzo espresso 
nella nostra moneta, mentre i navigatori slovacchi 
preferiranno che il prezzo sia mostrato in corone 
slovacche. Continuando nell'esempio un italiano 
preferirà che i dati tecnici delle autovetture siano 
espressi in unità quali Km/h per la velocità, KW per 
le potenze. Viceversa un utente proveniente dal 
Regno Unito o dall'Irlanda, affezionato al sistema 
imperiale, preferirà leggere le stesse grandezze 
espresse in Mph o HE Ecco quindi l'esempio del- 
l'importanza della localizzazione delle applicazioni 
nel caso si voglia raggiungere una vasta platea.Nello 
scorso numero di ioProgrammo abbiamo iniziato a 
sviluppare un'applicazione di esempio dedicata alle 
agenzie immobiliari. Utilizzeremo la stessa applica- 
zione come esempio per di localizzazione. Con 
molta probabilità, nella società multietnica in cui 
viviamo, sarebbe un punto a favore per l'agenzia se 
questa riuscisse a fornire schede dettagliate delle 
proposte immobiliare non solo in italiano, ma anche 
in spagnolo, arabo e cinese. 



INFORMAZIONI 

DI LOCALIZZAZIONE 

MEI BROWSER 

È utile una breve digressione riguardante il suppor- 
to della localizzazione da parte dei browser. Tutti i 



navigatori più diffusi e recenti inviano in una richie- 
sta http anche un header che indica in quale lingua 
l'utente vorrebbe visualizzare le pagine. In alcuni 
browser questo parametro è facilmente configurabi- 
le, in altri assume un valore in base alla localizzazio- 
ne scelta per il sistema operativo. In questo modo è 
possibile far si che un sito appaia nella lingua desi- 
derata senza la necessità di includere i tipici link con 
le bandierine, comuni in tanti siti, ma automatica- 
mente. In questo articolo vedremo come Struts sup- 
porta la localizzazione ed utilizzeremo proprio que- 
sto meccanismo per la localizzazione. 



LOCALIZZAZIONE DEI 
TESTI DI UNA PAGINA 

Java mette a disposizione una classe apposita per la 
localizzazione: la ResourceBundle. Essenzialmente 
questa classe associa delle risorse utili per la localiz- 
zazione a nomi ben definiti. Ad esempio è possibile 
includere l'oggetto per formattare valori di valuta col 
nome "currencyFormat", l'oggetto che formatta le 
date con il nome "dateFormat", l'oggetto che con- 
verte valori dal sistema metrico decimale al sistema 
locale come "physicFormat", un messaggio di errore 
con la stringa "errorMessage". A questo punto si pre- 
vede un ResourceBundle per ogni localizzazione che 
si vuole offrire ai propri utenti che registri con gli 
stessi nomi le risorse per la localizzazione. Ad esem- 
pio, il ResourceBundle per la localizzazione italiana 
avrà associato alla stringa "dateFormat" un oggetto 
che converte le date in formato giorno / mese / 
anno, mentre il Resource Bundle per l'inglese, alla 
stessa stringa "dateFormat" associerà un oggetto che 
converte le date nel formato mese / giorno / anno. 
Tipicamente si inserisce anche un ResourceBundle 
di default che viene caricato nel caso nessun 
ResourceBundle per la localizzazione specificata esi- 
sta. Nel caso non servano particolari oggetti che 
gestiscano le formattazioni, i ResourceBundle posso- 
no essere anche creati da property file. Vedremo 
come applicare tutto ciò in Struts 2. 
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PREPARAZIONE 

DEI RESOURCE BUMDLE 

Nella cartella dei sorgenti java del progetto creia- 
mo tre file con i seguenti nomi 

• RealEstate_it.properties: per la localizzazione 
in italiano 

• RealEstate_en.properties: per la localiz- 
zazione in inglese 

• RealEstate.properties: da utilizzare nel caso 
sia specificata una lingua per cui non e stato 
previsto alcun Resource Bundle 

I file il cui nome termina per _it e _en sono i file 
delle localizzazioni in inglese e italiano, mentre 
RealEstate.properties racchiude i messaggi nel caso 
sia richiesta una qualsiasi altra localizzazione. 



COMPILAZIONE 

DEI RESOURCE BUMDLE 

Immettete i seguenti contenuti nel file 
RealEstate_it.properties 

site.title=Immobiliare IMMOBILIX 
form.searchProposal.title=Ricerca l'offerta migliore. 
form.searchProposal.minValue=Valore minimo. 
form.searchProposal.maxValue=Valore massimo. 
form.searchProposal.minValue.label=Valore minimo 

dell'immobile. 
form.searchProposal.maxValue.label=Valore massimo 

dell'immobile. 
form.button.ok=OK 

search.results=Risultati corrispondenti alla ricerca. 
search.noResults=Nessun risultato trovato. 
back=indietro 



Immettete i seguenti contenuti nel file Real 
Estate_en.properties 



form.searchPro posai 


minvalue= 


= Minimum value. 




form.searchPro posai 


maxValue 


= Max 


mum value 




form.searchPro posai 


minValue. 


abel = 


Minimum value 








of 


proposal. 


form.searchPro posai 


maxValue 


labeh 


= Maximum 


i/alue 








of 


proposal. 


form.button.ok=OK 


search.results=Results found... 


search . noResults= Ne 


results found. 






back=back 



E per ultimo i seguenti nel file RealEstate.proper- 
ties, che caricato se il sito è richiesto in altre lin- 
gue, renderà palese tale situazione. 



site.title=XXX 


form 


search Proposal. title=XXX 






form 


search Proposal. minValue= 


=XXX 




form 


search Proposal. maxValue 


=XXX 




form 


search Proposal. minValue. 


abel = 


XXX 


form 


search Proposal. maxValue 


label = 


=XXX 


form.button.ok=XXX 


searc 


h.results=XXX 






searc 


h.noResults=XXX 






back 


=XXX 







UTILIZZO DEL RESOURCE 
BUNDLE IM PAGINE JSP 

Aprite ora la pagina index.jsp, già compilata nel 
precedente articolo e modificatela come 
descritto di seguito. In apertura e necessario 
utilizzare il tag Struts <s:il8n> per caricare il 
resource bundle, fornendo il nome dello stesso. 
Si noti che e il sistema a caricare il file corretto 
proprio in base al valore dellàheader HTTP 
inviato dal browser. 

<s:il8n name="RealEstate"> 




site.title=IMMOBILIX RealEstate 



form.searchProposal.title=Search for the best proposal. 



Qui avviene il primo interessante automatismo, 
difatti Struts, attraverso le librerie standard Java, 



V JnlnJ'jyiLlyf Jìaiiltsiiiia - ululili) Hraiuu! | = Il lai || u\ 


File Modifica Visualizza Vai Segnalibri Strumenti Guida 




.,'" □ http:. .712 7.0. - : Vai jGl lotteria italia 


g] IMMOBILIX RealEstate 


y -—[ Lotteriaitalia.net - il sito delle L... 1 £3 


Search for the best proposal. 
Minimum value.: .'. |i°u 

Maximum value is mandatory. 
Maximum value.: J.\~ 

QK | 


Completato 



liuiijuuiliiji-- Ji^l'JijJLL: - uJoviJj;, i-jr-ru/ 



File Modifica Visualizza Vai Segnalibri Strumenti Guida 
' ' " tSt © |@ http://127.0. |Q ©Vai (Q, lotteria italia 



1 Immobiliare IMMOBILIX 



Lj - — [ Lotteriaitalia.net - il sito delle L. 



Ricerca lofferta migliore. 
Valore minimo.: 'X. |ìoó 

Il valore massimo è richiesto 
Valore massimo.: J'.\~ 



Completato 



Fig. 1: In queste due immagini possiamo vedere i risultati delle nostre fatiche. La stessa pagina localizzata in italiano e inglese dopo aver 
opportunamente cambiato le impostazioni del browser. 
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controllerà il locale impostato dal browser prele- 
vandolo dagli header http e controllerà se tra tutti i 
ResourceBundle denominati RealEstate ce ne sia 
uno adatto alla localizzazione richiesta. Altrimenti 
carica quello di default. Quando poi si desidera uti- 
lizzare un testo non lo si deve includere più diretta- 
mente nella pagina ma invece inserirne il nome del 
messaggio nel ResourceBundle attraverso il tag 
Struts <s:text>. Ad esempio il seguente tag includerà 
il testo con nome form.searchProposal.title estratto 
dal ResourceBundle selezionato. 

<s:text name = "form.searchProposal.title"/> 



UTILIZZO DEL RESOURCE 
BUrMDLE 

In alcuni tag quali quello per definire i campi delle 
form non è possibile fare direttamente utilizzo delle 
risorse localizzate attraverso i ResourceBundle. Ad 
esempio se volessimo definire un campo di testo di 
una form non potremmo utilizzare: 

<s:textfi eld label = "form.searchProposal.minValue" 

name="minValue" 
tooltip="form.searchProposal.minValue.label"/> 

In un certo senso quello che dobbiamo fare è 
impostare gli attributi perché prendano il 
valore dal ResourceBundle. 
Per far questo possiamo sfruttare il supporto 
dei tag Struts2 al linguaggio di valutazione 
delle espressioni OGNL. Quando come valore 
di un attributo specifichiamo la stringa "%{}" 
questo fa si che l'espressione compresa tra 
parentesi graffe venga valutata e utilizzata 
come valore dell'attributo. Il caso in esame 
diverrebbe quindi: 

<s:textfield label = "%{getText('form.search Proposai . 

minValue')}" name="minValue" 
tooltip="%{getText('form.searchProposal.minValue.la 

bel')}7> 

Essendo getTextf) un metodo per l'estrazione dei 
valori dal resourceBundle. 



CONVERSIONE 
DELLE PAGINE 

Tenendo in conto quanto definito nel passo pre- 
cedente le pagine che compongono l'applicazio- 
ne potranno essere cosi trasformate. Per prima 
vediamo la pagina Index.jsp. 

<%@ taglib prefix="s" uri="/struts-tags" %> 



<%@ page language="java" contentType="text/ 

html; charset=UTF-8"%> 

[■■■] 

<s:il8n name=" RealEstate" >< html >< head > 



[...] 



<s:text name="site.title"x/s:text> 



[■ 



</head> 



<body> 



<s:text name= "form. search Proposai . 



title"/> 



<s:form action = "Search" method = "POST"> 



<s:actionerror/> 



<s:set name="label" scope="page" value= 



"/> 



<s:textfìeld label = "%{getText(' 



form. search Proposai . minValue')}" name= "minValue" 
tooltip="%{getText('form.searchProposal.minValue.la 

bel')}"/> 



<s:textfìeld label = "%{getText 
('form.searchProposal.maxValue')}" 



name="maxValue" 
tooltip="%{getText('form.searchProposal.maxValue. 

label')}"/> 
<s:submit value="%{getText 



('form.button.ok')}7> 


</s:form> 


</bodyx/htmlx/s:il8n> 



Questa è invece la pagina dedicata alla visualiz- 
zazione dei risultati. 



[...] 


<s:il8n name= 


RealEstate"> 


[...] 


<s:text name="site 


.title"x/s:text> 


[...] 


<s:if test= 


= "foundProposals= = null"> 


<s:text name="search. 


noResults"/> 


</s:if> 


<s:else> 


<s:text name="search. 


results"/> 


<table> 


<s:iterator value="found 


Proposals"> 


<trxtd> 


<s:property 


value = "description"/> 


</tdxtd> 


<s:property value="value"/> 


</tdx/tr> 


</s:iterator> 
</table> 


</s:else> 
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<a href="/realestate2/Index. 


jsp"xs:text name="back"/x/a> 


[...] 


</s:il8n> 



Rimangono ora da localizzare anche i 
Validator applicati attraverso l'xml automati- 
co. Per fare ciò è necessario prevedere altri file 
secondo la struttura <ClassName>_<Locale>. 
properties e precisamente i tre file: 
Search_en.properties, Search_it. properties, 
Search. properties. Di seguito riportiamo a 
testo di esempio il file per la localizzazione ita- 
liana. 



maxValueMandatory 


=11 valore massimo 


è richiesto 


maxValueTooLow=II 


valore deve essere 


maggiore 


di ${min} 


minValueMandatory= 


= 11 valore minimo è 


richiesto 


minValueTool_ow = II valore deve essere 


maggiore 


di ${min} 



I file di localizzazione dei validator deve esse- 
re posizionato sempre nella stessa cartella 
della classe che il validatore controlla, dove 
dovrebbe anche essere presente il file di defi- 
nizione del validatore. Proprio questo file deve 
essere variato perché non può più includere 
direttamente i messaggi da riportare in caso di 
errore, ma deve invece utilizzare i messaggi 
validati. Ecco come il file per la validazione si 
trasforma. 

<!DOCTYPE validators PUBLIC 
"-//OpenSymphony Group//XWork Validator 1.0.2 

//EN" 

"http://www.opensymphony.com/xwork/xwork- 

validator-1.0.2.dtd"> 
<validators> 



<field name="maxValue"> 



<field-validator type="required"> 



<message key="maxValueMandatory"/> 



</field-validator> 



<field-validator type="int"> 



<param name="min">0</param> 



<message key="maxValueTooLow"/> 



</field-validator> 



</field> 



<field name = "minValue"> 



<field-validator type="required"> 



<message key="minValueMandatory"/> 



</field-validator> 



<field-validator type="int"> 



<param name="min">0</param> 



<message key="minValueTooLow"/> 



</field-validator> 



</field> 



</validators> 



TEST FINALE 
coni UM BROWSER 

Avviate ora l'applicazione web portandovi 
nella directory bin della vostra installazione 
di Tomcat e lanciando il comando "Catalina 
start". 

Testiamo ora la localizzazione con un brow- 
ser. Nell'esempio utilizziamo Firefox. Seguite 
la seguente procedura per giungere alla fine- 
stra delle impostazioni delle lingue di pagina 
preferita. 

• Cliccare sul menù "Modifica" 

• Scegliere la voce "Preferenze" 

• Nella finestra che appare premere il tasto 
"avanzate" 

• Cliccare sul tab "generale" 

• Nel riquadro "lingue" identificare e clic- 
care il bottone "scegli lingue" 

A questo punto si apre una finestra con elen- 
cati in ordine di priorità le lingue nelle quali 
desidereremmo visualizzare le pagine. Per le 
nostre prove necessitiamo dell'inglese, dell'i- 
taliano e di un'altra lingua, ad esempio lo spa- 
gnolo. Quindi per ognuna delle lingue che 
eventualmente non dovessero essere presenti 

• premete il bottone 
"scegli una lingua 
da aggiungere" 

• selezionate la lin- 
gua da aggiun- 
gere. 

Per testare il sito 
agite nella finestra 
selezionando una 
delle tre lingue e pre- 
mendo ripetutamen- 
te il bottone "sposta 
su" in modo da far 
diventare quella lin- 
gua quella a massima priorità. 
Potrete cosi controllare che nei tre casi il sito 
apparirà localizzato nella corrispondente 
maniera. 

Nel caso non abbiate variato nessun parame- 
tro l'applicazione dovrebbe rispondere 
all'URL http:// 127. 0.0.1:8080/realestate/ 
Index.jsp. 

In dettaglio per Firefox esistono anche delle 
estensioni che permettono di cambiare la lin- 
gua preferita con pochi click. 

Daniele De Michelis 












rm 1 
















.e pagine web vengono spesso offerte in più lir 
jossibile scegliere la lingua predefinita per que 
ordine di preferenza. 

Jngue in ordine di preferenza: 


gue. È 

ste pagine, in 






Inglese [en] 




Sposta su 




[it-it] 

Italiano [it] 

Inglese/Stati Uniti [en-us] 








! 


Sposta giù 










1 


Rimuovi 


















Scegliere una lingua da aggiungere... t 


| aggiungi 




















© 




-^Annulla 




<^0K 



















Fig. 1: Questa è la finestra dell'impostazione della lin- 
gua preferita in Firefox. 



http://www.ioprogrammo.it 



Maggio 2007/ 81 ► 



084-088 30-03-2007 15:17 Pagina 84 



TIPS&TRICKS T H Una raccolta di trucchi da tenere a portata di... mouse 



I trucchi del mestiere 

Tips & TVicks 

Questa rubrica raccoglie trucchi e piccoli pezzi di codice, frutto dell'esperienza di chi programma, che solitamente non 
trovano posto nei manuali. Alcuni di essi sono proposti dalla redazione, altri provengono da una ricerca su Internet, altri 
ancora ci giungono dai lettori. Chi volesse contribuire, potrà inviare i suoi Tips&Tricks preferiti. Una volta selezionati, 
saranno pubblicati nella rubrica. Il codice completo dei tips è presente nel CD allegato nella directory \tips\ o sul Web 
all'indirizzo: cdrom.ioprogrammo.it. 




CREAZIONE DI PDF 

Come posso creare un PDF on the fly? 

Utilizzando ad esempio la libreria iText.net disponibile per il 
download all'indirizzo itextsharp.sourceforge.net 



// step 5: Remember to dose the documnet 



myDocument.Close(); 



} 



ANTEPRIME 

Come posso creare la thumbnail di un'immagine? 



Un esempio di codice è il seguente 



using System; 



using System. IO; 



using System. Diagnostics; 



using iTextSharp.text; 



using iTextSharp.text.pdf; 



public class iTextDemo 



{ 



public static void Main() 



{ 



Console. WriteLine("iText Demo"); 



// step 1: creation of a document-object 



Document myDocument = new Document(PageSize.A4.Rotate()); 



try 



{ 



// step 2: 



// Now create a writer that listens to this doucment and writes 

the document to desired Stream. 
PdfWriter.GetInstance(my Document, new 

FileStream("Salman.pdf", FileMode. Create)); 



// step 3: Open the document now using 



myDocument.Open(); 



// step 4: Now add some contents to the document 
myDocument. Add(new Paragraph("First Pdf File made by Salman 

using iText")); 



} 



catch(DocumentException de) 



{ 



Console. Error.WriteLine(de.Message); 



} 



catch(IOException ioe) 



{ 



Console. Error.WriteLine(ioe.Message); 



} 



private void ShowThumbnailQ 



{ 



try 



{ 



if(lstV.Items.Count>0) 



{ 



Bitmap bmp=new Bitmap("img.jpg"); 



int wid = bmp.Width; 



int hei=bmp.Height; 



float per=0,reduceByH=0,reduceByW=0; 



if(hei>wid) 



{ 



for(int i=l;i< = 100;i++) 



{ 



per=(hei*i)/100; 



if((per+10)>140) 



{ 



reduceByW= 



break; 



} 



} 



//MessageBox.Show(per.ToString()+" "+reduceByW.ToString() 

+" M +reduceByH.ToString()); 



reduceByH = (wid*reduceByW)/100; 



imgThumb.Image=GenerateThumb(Convert.ToInt32(reduceByH), 

Convert.ToInt32(per)); 



/*float diffh,diffw; 



diffw=((bmp.Height-imgThumb.Height)*imgThumb.Height)/bmp.Height; 



float perl=100*diffw/bmp.Height; 



float newHei=bmp.Width*perl/100; 



imgThumb.Image=GenerateThumb(Convert.ToInt32(newHei), 

Convert.ToInt32(diffw)); 



*/ 



} 



else 
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{ 



float diffh.diffw; 



diffw=((bmp.Width-imgThumb.Width)*imgThumb.Width)/bmp.Width; 



float perl = 100*diffw/bmp.Width; 



float newHei=bmp.Height*perl/100; 



imgThumb.Image=GenerateThumb(Convert.ToInt32(diffw),Convert. 

ToInt32(newHei)); 



/* 



* OR 



for(int i=l;i< = 100;i++) 



{ 



per=(wid*i)/100; 



//MessageBox.Show(per.ToStringO); 



if((per+10)>140) 



{ 



reduceByW= 



break; 



} 



else 



} 



//MessageBox.Show(per.ToString()+" M +reduceByW.ToString() 

+" n +reduceByH.ToString()); 



reduceByH = (hei*reduceByW)/100; 



imgThumb.Image=GenerateThumb(Convert.ToInt32(per),Convert. 

ToInt32(reduceByH)); 



*/ 



} 



} 



catch(Exception ex) 



{ 



//MessageBox.Show(ex.Message,"Error",MessageBoxButtons.OK, 

MessageBoxIcon . Errar); 



} 



} 



private System. Drawing.Image GenerateThumb(int wid,int hei) 



{ 



System. Drawing.Image image = 

System. Drawing.Image. FromFile(lstV.SelectedItems[0].Text); 
System. Drawing.Image 
thump=image.GetThumbnailImage(wid, hei, nuli, new System. IntPtrQ); 



return thump; 



} 



PULSANTI AL VOLO 

Come posso generare un pulsante a runtime? 

/ This is a function for generation of a button Control cali this 
function in Page Load event but before using this function u need 
to place one Panel control in urWeb page(here the id of Panel is 
Panell) 

public void GenerateButton() 



{ 


Button btn = new ButtonQ; 


btn.ID = "btnOK"; 


btn.Text = "OK"; 


btn.BorderStyle = BorderStyle.Groove; 


btn.Width = 71; 


btn.Height = 32; 


btn.BackColor = System. Drawing.Color.LightSteeIBlue; 


btn.ForeColor = System. Drawing.Color.Crimson; 


Panell. Controls.Add(btn); 


btn. Click += new EventHandler(btnOK_Click); 


} 


//this 


function used for Click event of Generated button 


protected void btnOK_Click(object sender, EventArgs e) 


{ 


Response.Write("Hello! Button Generated"); 


} 


// 




VB.NET 

INTERAGIRE 
COI\l IL CESTINO 

Come posso svuotare il cestino di Windows? 

Dim Action As New ShellActions 
Action. EmptyRecycleBin() 
Public Class ShellActions 
Shared Function _ 
SHEmptyRecycleBin(ByVal hWnd As Integer, 

ByVal pszRootPath As String, . 
ByVal dwFlags As Integer) As Integer 
End Function 
Sub New() 
EmptyRecycleBinQ 
End Sub 

Sub EmptyRecycleBin(Optional ByVal rootPath As String = "", _ 
Optional ByVal noConfirmation As Boolean = True, 

Optional ByVal NoProgress . 
As Boolean = True, Optional ByVal NoSound As Boolean = True) 
Const SHERB_NOCONFIRMATION = &H1 
Const SHERB_NOPROGRESSUI = &H2 
Const SHERB_NOSOUND = &H4 



If rootPath. Length > AndAlso rootPath. Substring(l, 2) 

<> ":\" Then 
rootPath = rootPath. Substring(0, 1) & ":\" 
End If 



Dim flags As Integer = (noConfirmation And 

SHERBJMOCONFIRMATION) Or _ 
(NoProgress And SHERBJMOPROGRESSUI) Or (NoSound And 

SHERB_NOSOUND) 
SHEmptyRecycleBin(0, rootPath, flags) 

End Sub 
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COMBOBOX E COLORI 

Come posso riempire una combo con il nome dei colori di 
sistema? 



Private Sub Button2_Click(ByVal sender As System. Object, ByVal e 
As System. EventArgs) Handles Button2. Click 

Dim typ As System. Type = GetType(System.Drawing. Color) 

Dim aPropInfo As System. Reflection.PropertyInfo() = 

typ.GetPropertiesQ 

For Each pi As System. Reflection. _ 

Propertylnfo In aPropInfo 

If pi.PropertyType.Name = "Color" _ 

And pi.Name <> "Transparent" Then 

Me.ComboBoxl.Items.Add(pi.Name) 

End If 

Next 
Private Sub ComboBoxl_SelectedIndexChanged(ByVal sender As 
System. Object, ByVal e As System. EventArgs) Handles 
ComboBoxl.SelectedlndexChanged 
frm.BackColor = Color.FromName 

_(Me.ComboBoxl.SelectedItem) 
End Sub 



INFORMAZIONI 
SUL NETWORKING 

Come posso ottenere l'elenco delle schede di rete? 

Option Strict On 
Option Explicit On 
Imports System 
Imports System. Management 
Public Class ConsoleApp 
Shared Sub Main 

Network. EnumNetworkAdapters() 
End Sub 
End Class 
Public Class Network 

Public Shared Sub EnumNetworkAdapters() 

Dim query as ManagementObjectSearcher = new 

ManagementObjectSearcher("SELECT * FROM 
Win32_NetworkAdapterConfiguration") 
Dim queryCollection as ManagementObjectCollection = 

query.Get() 
Dim mo as ManagementObject 
Dim s as String 
for each mo in queryCollection 

Console. WrìteLine( "'{0}"', mo.ClassPath) 



Console. WriteLine( '"{0}'", mo.Options) 



Console. WriteLine( "Index '{0}'", mo("Index")) 



Console. WriteLine( "Description '{0}" 



mo("Description")) 



Console. Writel_ine( "MacAddress '{0}" 



mo("MacAddress")) 



if(CType(mo("IPEnabled"), Boolean) = true) 



dim addresses() as string = CType(mo("IPAddress"), 

StringQ) 

dim subnets() as string = CType(mo("IPSubnet"), 

StringQ) 

Console. WriteLine( "DNS Host '{0}"', 

mo("DNSHostName")) 
Console. WriteLine( "DNS Domain '{0}'", 

mo("DNSDomain")) 
for each s in addresses 

Console. Writel_ine( "IP Address '{0}"', s) 
next 
for each s in subnets 

Console. Writel_ine( "IP Subnet '{0}'", s) 
next 
end if 
next 
End Sub 
End Class 



BARRA DEL TITOLO 

Come posso intercettare il click sulla caption bar? 

Option Strict On 

Option Explicit On 

Imports System 

Imports System. Windows. Forms 

Imports System. Drawing 

Public Class Formi 

Inherits Form 

Private ReadOnly WM_NCLBUTTONDOWN As Integer = &HA1 
Public Sub New() 

Me.Text = "Window Caption" 

End Sub 

Protected Overrides Sub WndProc(ByRef m As Message) 



If m.msg = WM_NCLBUTTONDOWN Then 



Console. WriteLine("caption click...") 
End if 
MyBase.WndProc(m) 



End Sub 
<STAThread()> 



Shared Sub Main() 

Application. Run(New Forml()) 



End Sub 



End Class 
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JAVA 



DIRECTORY E REGEX 

Come posso ottenere l'elenco dei file che matchano 
un pattern? 

import java. io. File; 

import java.io.FilenameFilter; 

import java.util.Arrays; 



import java.util.Comparator; 



import java. util.regex. Pattern; 



public class DirList { 



public static void main(String[] args) { 



File path = new File("."); 



String[] list; 



if (args.length 



0) 



list = path. Iist(); 



else 



list = path.list(new DirFilter(args[0])); 



Arrays.sort(list, new AlphabeticComparatorQ); 



for (int i = 0; i < list.length; i + + ) 



System. out.println(list[i]); 



class DirFilter implements FilenameFilter { 



private Pattern pattern; 



public DirFilter(String regex) { 



pattern = Pattern, compile(regex); 



} 



public boolean accept(File dir, String name) { 
// Strip path information, search for regex: 



return pattern. matcher(new File(name).getl\lame()).matches(); 



} 



}///: 



class AlphabeticComparator implements Comparator { 



public int compare(Object ol, Object o2) { 



String si = (String) ol; 



String s2 = (String) o2; 



return sl.toLowerCase().compareTo(s2.toLowerCase()); 



} 



}///:- 

COPIARE UHI FILE 

Come posso farlo rapidamente? 

import java. io. File; 



import java.io.FilelnputStream; 



import java.io.FìleOutputStream; 



import java.io.IOException; 



public class CopyBytes { 



public static void main(String[] args) throws IOExceptìon { 
File inputFile = new File("input.txt"); 
File outputFile = new File("output.txt"); 



FilelnputStream in = new FilelnputStream(inputFile); 
FileOutputStream out = new FileOutputStream(outputFile); 
int e; 



while ((e = in.read()) 



-1) 



out.write(c); 



in.close(); 



out.close(); 



} 



} 



COMPARARE LE MODIFICHE 

Come posso sapere quale file è stato modificato prima? 

import java. io. File; 

public class CompareFileDates { 
public static void main(String[] args) { 
// Get the timestamp from file 1 
String fi = "run.bat"; 
long di = new File(fl).lastModified(); 

// Get the timestamp from file 2 

String f2 = "build.xml"; 

long d2 = new File(f2).lastModified(); 

String relation; 

if (di == d2) 

relation = "the same age as"; 
else if (di < d2) 

relation = "older than"; 
else 

relation = "newer than"; 
System. out. println(fl + " is " + relation + ' ' + f2); 
} 




PHP 



OTTENERE LA DATA 



Come convertire un timestamp? 



<? 


while 


(true) 






{ 




// Read a 


line from standard 


in. 


echo "enter time to converti "; 




$inline = 


fgets(STDIN); 






$inline = 


trim($inline); 






if ($inline 


= = "" 1 1 $inline = = 


= ".") 
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} elseif ($pathfile != $this->tar_file) { 



break; 




// See if the line is a date. 


$pos = strpos($inline, "/"); 


if ($pos = = = false) { 


// not a date, should be an integer. 


$date = date("m/d/Y G:i:s", $inline); 


echo "int2date: $inline -> $date\n"; 


} else { 


$itime = strtotime($inline); 


echo "date2int: $inline -> $itime\n"; 


} 


} 


?> 



CREARE L'ARCHIVIO 

Come posso generare un file tar? 

<?php 



/*** 



^^^c*^^:^:^:^:^:*^***^:^*:):^:*****:):^:^:^::):*****^::):^:^:^:*****^:*:^:^^: 



* Title: Classic-TAR based backup script vO.O.l-dev 



Class Tar_by_Vladson { 



var $tar_file; 



var $fp; 



function Tar_by_Vladson($tar_file='backup.tar') { 



$this->tar_file = $tar_file; 



$this->fp = fopen($this->tar_file, "wb"); 



$tree = $this->build_tree(); 



$this->process_tree($tree); 



fputs($this->fp, pack("a512", "")); 



fclose($this->fp); 



function build_tree($dir='.'){ 



$handle = opendir($dir); 



while(false ! = = ($readdir = readdir($handle))){ 



if($readdir 



&& $readdir ! = 



■'){ 



$path = $dir.'/'.$readdir; 



if (is_file($path)) { 



$output[] = substr($path, 2, strlen($path)); 



} elseif (is_dir($path)) { 



$output[] = substr($path, 2, strlen($path)).'/'; 
$output = array_merge($output, $this- 

>build_tree($path)); 



_} 

closedir($handle); 



return $output; 



} 



function process_tree($tree) { 



foreach( $tree as $pathfile ) { 



if (substr($pathfile, -1, 1) 



'/'){ 



fputs($this->fp, $this->build_header($pathfile)); 



$filesize = filesize($pathfile); 



$block_len = 512*ceil($filesize/512)-$filesize; 
fputs($this->fp, $this->build_header($pathfile)); 
fputs($this->fp, file_get_contents($pathfile)); 
fputs($this->fp, pack("a".$block_len, "")); 



return true; 

_} 

function build_header($pathfile) { 



if ( strlen($pathfile) > 99 ) die('Error'); 



$info = stat($pathfile); 



if ( is_dir($pathfile) ) $info[7] = 0; 



$header = pack("al00a8a8a8al2A12a8alal00a255" 



$pathfile, 



sprintf("%6s ", decoct($info[2])), 



sprintf("%6s ", decoct($info[4])), 



sprintf("%6s ", decoct($info[5])), 



sprintf("%lls ",decoct($info[7])), 



sprintf("%lls", decoct($info[9])), 



sprintf("%8s", " "), 



(is_dir($pathfile) ? "5" : "0"), 



clearstatcache(); 



$checksum = 0; 



for ($i=0; $i<512; $i++) { 



$checksum += ord(substr($header,$i,l)); 



$checksum_data = pack( 



"a8", sprintf("%6s ", decoct($checksum)) 



); 



for ($i=0, $j = 148; $i<7; $i++, $]+ + ) 



$header[$j] = $checksum_data[$r 



return $header; 



header('Content-type: text/plain'); 



$start_time = array_sum(explode(chr(32), microtime())); 



$tar = tk new Tar_by_Vladson(); 



$finish_time = array_sum(explode(chr(32), microtime())); 



printf("The time taken: %f seconds", ($finish_time - $start_time)); 
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PROGRAMMARE 00 



CON "SANI PRINCIPI 



II 



IMPAREREMO COME SCRIVERE SOFTWARE PULITO, FACILMENTE MANUTENIBILE 
E DOCUMENTABILE. VEDREMO COME ALCUNE SEMPLICI REGOLE DI BUONA 
PROGRAMMAZIONE POSSONO AIUTARCI ENORMEMENTE NELLO SVILUPPO 



Uno degli indici più importanti nel valutare la 
qualità di un progetto software è rappresen- 
tato dalla sua capacità di cambiare ed adat- 
tarsi a nuove esigenze. Questo aspetto, nelle vecchie me- 
todologie di sviluppo veniva un po' snobbato in quan- 
to si riteneva che i requisiti necessari da implemen- 
tare fossero già in fase di analisi. 
Con il passare del tempo ci si è resi conto che i cam- 
biamenti ricoprono un ruolo determinante nel pro- 
cesso di produzione, quindi bisogna utilizzare un co- 
dice propenso al refactoring, ovvero pronto ad essere 
modificato per supportare nuovi requisiti. Questo ap- 
proccio, adottato dalle metodologie Agili, ha fatto re- 
gistrare un notevole abbattimento dei costi nel ciclo di 
realizzazione di progetti medio-grandi. In questo ar- 
ticolo prenderemo in esame alcuni principi di pro- 
grammazione object-oriented, che rendono il codice 
più flessibile ed aperto ad estensioni. Data la natura di- 
dattica utilizzeremo degli esempi apparentemente 
banali per capire i vantaggi nell'applicazione di alcu- 
ni principi. 



litri = km/8f; 



}else if(this.modello= = MONOVOLUME){ 



litri= km/14f; 



}/*else if(this.modello==JEEP){ 



litri = km/9f; 



}else if(this.modello==UTILITARIA){ 



litri= km/16f; 



}*/ 



return litri; 



} 



public static void main(String [] ar){ 



Automobile spider=new Automobile(SPIDER); 
Automobile monovolume=new Automobile 



(MONOVOLUME); 



//Automobile jeep=new Automobile(JEEP); 
//Automobile utilitaria=new Automobile(UTILITARIA); 
System. out.println(spider.calcolaConsumo(200)); 



System. out.println(monovolume. calcola 



Consumo(200)); 



//System. out.println(jeep.calcolaConsumo(200)); 
//System. out.println(utilita ria. calcolaConsumo(200)); 



} 



} 




AUTO POCO OCP 

Supponiamo di dover realizzare un sistema che cal- 
coli i consumi di due tipi di automobile (spider e mo- 
novolume) in base ai chilometri percorsi. Quindi, in 
modo abbastanza naturale, potremmo pensare di uti- 
lizzare il seguente codice: 

public class Automobile { 
public static final int SPIDER=0; 
public static final int JEEP=1; 
//public static final int MONOVOLUME=2; 
//public static final int UTILITARIA=3; 

private int modello=-l; 
public Automobile(int modello){ 
this.modello= modello; 

} 

public float calcolaConsumo(int km){ 

float litri=0; 

if(this.modello==SPIDER){ 



Tralasciando per il momento le parti commentate, 
possiamo affermare che il precedente listato defini- 
sce una classe Java che risolve il nostro problema. Il 
metodo calcolaConsumo, una volta capito il modello 
in questione, calcola il consumo in litri in base ai km 
percorsi. Ma cosa succederebbe se il nostro requisito 
iniziale venisse un po' esteso e si volessero conside- 
rare anche altri tipi di auto come le jeep e le utilitarie? 
La risposta è già nel codice, basta eliminare i com- 
menti per ottenere la soluzione. Così facendo si tiene 
in vita un codice poco manutenibile e che (finalmen- 
te lo diciamo) non rispetta il principio OCP Ciò rende 
la sua gestione molto costosa e quindi poco sosteni- 
bile. OCP è l'acronimo di Open Closed Principle, e sta- 
bilisce che "una classe dovrebbe essere aperta (open) 
alle estensioni e chiusa (closed) alle modifiche". Quin- 
di non si dovrebbe mai modificare il codice già scrit- 
to ma estenderlo per aggiungere nuove features. La 
nostra classe invece per essere utilizzata per nuovi 
modelli prevede modifiche sostanziali. 



n 




REQUISITI 



■W.I.I.WJ.HJJ, 



G Java 



■ K JDK 1.4 o superiori 



' ■-'"■■-i \ ■-'-■■ -.-i I r ::: -.-\ I -""-"- A 



Tempo di realizzazione 



00 
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OCP E' MEGLIO! 

Cerchiamo adesso di risolvere lo stesso problema te- 
nendo in mente il principio OCP ed utilizzando co- 
strutti tìpici dei linguaggi Object Oriented quali le in- 
terfacce. Definiamo infatti un'interfaccia per l'entità au- 
tomobile: 

public interface IAutomobile { 

public float calcolaConsumo(int km); 
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Figura 1: OCP descritto da www.oodesign.com 



siti. Il rispetto di tali principi invece predispone le no- 
stre classi ad essere estese e non modificate soprattu- 
to nel caso in cui la firma dei metodi non cambi. Nel 
nostro esempio saremmo obbligati a modificare co- 
dice se per calcolare i consumi si volessero introdur- 
re altri parametri quali la velocità media e ... larghez- 
za degli pneumatici. 



VIOLARE LSP 

Alziamo un po' il livello di complessità e supponiamo 
di dover realizzare un ComputerDiBordo che riesca a 
calcolare l'autonomia di un'automobile in base ai litri 
di carburante presenti ed in base alla capacità di per- 
correnza dell'automobile stessa. Potremmo pensare di 
utilizzare la seguente interfaccia per definire i com- 
portamenti (o metodi) di un'automobile. 



public interface IAutomobile { 


public void setBenzina(int benz); 


public int getBenzinafJ; 


public float getKmPerLitro(); 


} 



Cosi facendo ogni modello di automobile può avere la 
sua implementazione e definire i propri consumi. 



Mentre la classe ComputerdiBordo potrebbe avere la 
seguente implementazione: 



public class Spider implements IAutomobile { 
public float calcolaConsumo(int km) { 
return km/8f; 



public class ComputerDiBordo { 



} 



} 

public class Monovolume implements IAutomobile { 



public float calcolaConsumo(int km) { 

return km/14f; 
} 



} 



Questo approccio, che rispetta OCP permette di ag- 
giungere nuovi modelli senza modificare il codice già 
scritto, quindi è aperto alle estensioni ... 



public class Jeep implements IAutomobile { 


public float calcolaConsumo(int 


km){ 


return km/9f; 


} 


} 


public class Utilitaria implements 


IAutomobile { 


public float calcolaConsumo(int 


km){ 


return km/16f; 


} 


} 



... e chiuso alle modifiche. 

C'è da dire che il rispetto di questo ed anche di tutti 
gli altri principi, non ci assicura che il nostro codice 
non verrà mai modificato in presenza di nuovi requi- 



public float calcolaKMPercorribili(IAutomobile auto){ 



float kmP=0; 



kmP=auto.getBenzina()*auto.getKmPerLitro(); 



return kmP; 



} 



} 



Come possiamo notare al momento nostro codice è 
OCP in quanto possiamo utilizzare la classe Compu- 
terDiBordo passando al suo unico metodo diverse im- 
plementazioni dell'interfaccia IAutomobile. Suppo- 
niamo che a causa di nuove esigenze di progetto deb- 
bano essere gestite anche le automobili con doppia 
alimentazione. Tanto per intenderci meglio, conside- 
riamo il caso in cui il nostro ComputerDiBordo possa 
essere istallato anche su auto aventi la seguente in- 
terfaccia: 

public interface IAutomobileDoppiaAlimentazione extends 

IAutomobile{ 

public int getIdrogeno(); 

public void setIdrogeno(int h); 
} 

A questo punto una possibile soluzione potrebbbe es- 
sere quella di modificare la classe ComputerDiBordo 
nel seguente modo: 
public class ComputerDiBordo { 
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public float calcolaKMPercorribili(IAutomobile auto){ 
float kmP=0; 

kmP=auto.getBenzina()*auto.getKmPerLitro(); 
return kmP; 

_} 

public float calcolaKMPercorribiliH(IAutomobileDoppia 

Alimentazione auto){ 
float kmP=0; 
kmP=auto.getBenzina()*auto.getKmPerLitro()+ 

auto.getIdrogeno()*auto.getKmPerLitro(); 
return kmP; 



} 



} 



In questo modo il calcolo dei Kilometri percorribili 
verrebbe effettuato in base al metodo invocato. Il tut- 
to potrebbe funzionare bene ma vediamo cosa può 
essere migliorato in questa nuova implementazione. 



SI GRAZIE! 

Partiamo da una considerazione: cosa succederebbe 
se da qualche parte venisse utilizzato un codice simi- 
le al seguente? 



Al contrario l'interfaccia IAutomobileDoppiaAlimen- 
tazione non necessita di nessuna modifica, deman- 
dando alle sue implementazioni il calcolo dei chilo- 
metri percorribili sfruttando entrambi i tipi di ali- 
mentazione. 

public class AutoH implements IAutomobileDoppia 

Alimentazione{ 

public float calcolaKMPercorribiliQ { 



float kmP=0; 



kmP=this.getBenzina()*this.getKmPerl_itro()+ 



this.getIdrogeno()*this.getKmPerLitro(); 



return kmP; 



} 



} 



In questo caso il codice, che in precedenza evi- 
denziava problemi di non rispetto di LSP, continua 
a funzionare sia se al metodo si passa una IAutomobile 
e sia se si passa una IAutomobileDoppiaAlimenta- 
zione. 




ComputerDiBordo cdb=new ComputerDiBordo(); 
IAutomobileDoppiaAlimentazione a2=... 
float km=cdb.calcolaKMPercorribili(a2); 



A livello sintattico il codice è corretto ma la se- 
mantica espressa non lo è. In pratica il codice è 
compilabile ed eseguibile ma il suo impiego con- 
duce ad un calcolo sbagliato perché tiene conto so- 
lo di un tipo di alimentazione dell'automobile. 
Anche questa volta (e finalmente ...) è giunta l'o- 
ra di introdurre il principio che regola ed evita il 
presentarsi di tali inconvenienti. 
LSP è l'acronimo di Liskov Substitution Principle, 
e stabilisce che "Se un metodo di una classe ac- 
cetta parametri di tipo X, allora lo stesso metodo 
deve continuare a funzionare anche per tutti i sot- 
totipi Y di X". Questo principio viene palesemen- 
te violato dalla classe ComputerDiBordo e l'ab- 
biamo dimostrato nel precedente esempio. Per 
rimediare a tale inconveniente e per rispettare 
LSP possiamo utilizzare i seguenti accorgimenti. 
Per prima cosa demandiamo all'interfaccia IAu- 
tomobile il calcolo dei chilometri percorribili. 

public interface IAutomobile { 
public void setBenzina(int benz); 
public int getBenzinaQ; 
public float getKmPerLitro(); 
public float calcolaKMPercorribiliQ; 



DEPENDENCY 
INVERSIONI PRINCIPLE 

Abbiamo imparato due principi di OO che sicura- 
mente ci aiuteranno in molte occasioni a valutare la bontà 
del codice scritto. A questi principi se ne possono ag- 
giungere degli altri che però da questi derivano. Per 
introdurre il prossimo principio, come al solito, partiamo 
da un problema semplice ma concreto. Supponiamo 
di dover realizzare una semplice centralina elettroni- 
ca (CE) che legge i dati da un sensore e li trasmette ad 
un display. Allora, spinti dalla voglia di scrivere codi- 
ce, potremmo essere tentati di utilizzare la seguente im- 
plementazione. 

public class Display { 

public void mostra(int valore){ 
System. out.println(valore); 



public class Sensore { 
public int leggiValore(){ 
int valore=0; 



return valore; 



public class CentralinaElettronica { 
private Sensore sensore=null; 
private Display display=null; 
public CentralinaElettronica(Sensore s,Display d){ 



DIP E IOC 

I Framework come 
Spring, basati 
sull'lnversion of 
Control, sono 
un'evoluzione 
dell'applicazione del 
principio DIR. Infatti 
permettono di 
scrivere in modo 
indipendente i vari 
moduli di un 
progetto e di 
metterli insieme per 
mezzo di file di 
configurazione XML. 
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this.sensore=s; 



public interface IDisplay { 



this.display=d; 



public void start(){ 



int valore=0; 



while((valore= (sensore. leggivalore()))>=0){ 



display.mostra(valore); 



La classe Sensore non fa altro che esporre un metodo 
che legge un valore di tipo int. Invece la classe Display 
visualizza il valore di tipo int che gli viene passato. La 
classe CentralinaElettronica non fa altro che leggere 
in continuazione dal sensore il corrispondente valo- 
re e visualizzarlo utilizzando il display. A questo pun- 
to pensiamo un po' alla possibilità di riutilizzare la 
classe CentralinaElettronica, i più smaliziati si saran- 
no già accorti che tale possibilità è praticamente nul- 
la. Questa classe può essere utilizzata solo in questo 
contesto, perché è troppo legata alle implementazio- 
ni di Sensore e Display. Ancora, cosa succederebbe se 
la casa produttrice di Sensori (o di Display) decidesse 
di dover cambiare l'implementazione del metodo leg- 
giValore e quindi di dover rilasciare una nuove ver- 
sione di Sensore? Succede che ci tocca modificare e 
ricompilare il nostro codice e questo corrisponde ad 
un enorme spreco di tempo e denaro. 



IUOIU LEGARSI TROPPO... 

In definitiva per riutilizzare il codice di CentralinaE- 
lettronica e per poterla utilizzare con Sensori e Display 
che hanno diverse implementazioni interne, ma che 
verso il mondo esterno espongono le stesse funzio- 
nalità, non ci resta che applicare il principio DIP al no- 
stro esempio. 

DIP è l'acronimo di Dependency Inversion Principle 
(Principio di Inversione della Dipendenza), e stabili- 
sce che: "Le classi di alto livello dovrebbero dipende- 
re dalle astrazioni, le astrazioni non dovrebbero di- 
pendere dalle classe di basso livello, le classi di basso 
livello (o dettagli) dovrebbero dipendere dalle astra- 
zioni". La precedente è una traduzione più o meno fe- 
dele dell'enunciato originale, in pratica il tutto po- 
trebbe essere riassunto e reso più comprensibile nel se- 
guente modo: "In un progetto software realizzato con 
un linguaggio OO, due o più classi concrete non do- 
vrebbero mai avere dipendenze dirette, inoltre le interfacce 
non dovrebbero mai dipendere da classi concrete". 
Applicando questo principio allo scenario visto in pre- 
cedenza dovremmo fare in modo da disaccoppiare le 
classi in gioco. Quindi iniziamo con l'implementa- 
zione di due banali interfacce. 



public void mostra(int valore); 



public interface ISensore { 



public int leggivaloreQ; 



Queste interfacce (astrazioni) non dipendono da nes- 
suna classe concreta quindi al momento il DIP è ri- 
spettato. 



public 


class Display 


mplements IDisplay{ 




} 

public 


class Sensore 


implements ISensore{ 




} 



Queste classi concrete presentano quasi lo stesso co- 
dice visto in precedenza, infatti rispetto alla prima ver- 
sione cambia solo che implementano una ben defi- 
nita interfaccia. 

Rivediamo allora l'implementazione della classe Cen- 
tralinaElettronica, introducendo dipendenze solo dal- 
le astrazioni appena definite. 

public class CentralinaElettronica { 
private ISensore sensore=null; 
private IDisplay display=null; 



public void start(){ 



int valore=0; 



while((valore= (senso re. leggiValore()))>=0){ 



display.mostra(valore); 



public CentralinaElettronica(ISensore s,IDisplay d){ 



this. senso re=s; 



this.display=d; 



} 



Come possiamo notare abbiamo solo sostituito a quel- 
le che erano classi concrete le loro rispettive astrazio- 
ni. Anche in questo caso abbiamo rispettato il DIP e 
di conseguenza ne abbiamo tratto notevoli vantaggi in 
termini di riutilizzo e manutenibilità. Infatti in que- 
st'ultimo esempio, se volessimo utilizzare un SuperSensore, 
che continua ad implementare l'interfaccia ISensore ma 
che contiene una diversa modalità di lettura, non do- 
vremmo fare altro che passarlo come parametro al co- 
struttore. Non ci sarebbe bisogno di cambiare una so- 
la riga di codice nella classe CentralinaElettronica, la 
stessa classe potrebbe essere riutilizzata quindi in un 
contesto su cui non ci si era focalizzati al momento 
della sua realizzazione. 
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SINGLE RESPOIUSIBILITY 
PRIIUCIPLE 

Il principio che andiamo ad analizzare e conoscere 
adesso è un principio molto facile da capire ma un po' 
più difficile da applicare. Come nei precedenti casi 
partiamo da un esempio molto semplice ma essen- 
ziale per l'obiettivo che ci siamo prefissi. Supponia- 
mo di voler scrivere una semplice applicazione capa- 
ce di instanziare oggetti di tipo Automobile e di rendere 
tali oggetti persistenti su disco. Una semplice solu- 
zione al nostro problema potrebbe essere rappresen- 
tata dalla seguente classe. 



public class AutomobileSer implements 



Serializable{ 



private String modello=null 



private int cilindrataci; 



public int getCilindrataQ { 



return cilindrata; 



} 



public void setCilindrata(int cilindrata) 



this. cilindrata = cilindrata; 



} 



public String getModelloQ { 



return modello; 



} 



public void setModello(String modello) { 



this. modello = modello; 



public void carica(String fileName){ 



FilelnputStream fis=null 



AutomobileSer au=null 



try{ 



fis = new FilelnputStream(fileName); 



ObjectlnputStream ois = new 

ObjectlnputStream(fis); 
au=(AutomobileSer)ois.readObject(); 
this. setCilindrata(au. getCilindrataQ); 



this. setModello(au. getModelloQ); 



ois.closeQ; 



} catch (Exception e) { 



e.printStackTraceQ; 



} 



public void salva(String filelMame){ 



FileOutputStream fos; 



try{ 



fos = new FileOutputStream(fileName); 
ObjectOutputStream oos = new 

ObjectOutputStream(fos); 



oos. writeObject( this); 



oos.closeQ; 



} catch (Exception e) { 



e.printStackTraceQ; 



} 



La semantica di questa classe rispec- 
chia in tutto e per tutto il comporta- 
mento per cui è stata implementata. 
Sono presenti i setters ed i getters rela- 
tivi a modello e cilindrata. Inoltre sono 
presenti due metodi che consentono di 
salvare e recuperare oggetti istanze di 
questa classe, utilizzando il Filesystem 
come repository. Però analizzandola 
con attenzione possiamo notare che ci 
sono troppi motivi per cui in futuro po- 
trebbe essere modificata. Infatti po- 
trebbero essere apportate modifiche sia 
alla struttura dell'entità Automobile (ag- 
giunta di altri campi significativi: colo- 
re, tipo di carburante, numero di posti 
etc etc) sia alla modalità con cui è rea- 
lizzata la sua persistenza (utilizzo di un 
DB, dell'abbinamento di un DB con un 
ORM, etc etc). 
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Figura 2: II progetto visto da Eclipse 



UHI SOLO MOTIVO 
PER CAMBIARE! 

Forti di questa osservazione introduciamo un prin- 
cipio il cui focus è concentrato appunto su incon- 
venienti del genere. SRP è l'acronimo di Single Re- 
sponsibility Principle e stabilisce che: "Una classe 
dovrebbe aver un solo motivo per cambiare". Quin- 
di in questo contesto si associa alla parola respon- 



I QUATTRO PRINCIPI IN PILLOLE 



OCP: Open Close Principle, una 
classe dovrebbe essere aperta 
(open) alle estensioni e chiusa 
(closed) alle modifiche. Seguendo 
questo principio siamo capaci di 
estendere il comportamento di 
una classe senza modificarne il 
codice esistente. Diffidate di 
classi che contengono metodi in 
cui vi sono molti if(..) else if (..) in 
cascata, probabilmente la classe si 
presta ad un refactoring che 
prevede un'astrazione (tramite 
l'utilizzo di un'interfaccia). 
LSP: Liskov Substitution Principle, 
se un metodo di una classe 
accetta parametri di tipo X, allora 
lo stesso metodo deve continuare 
a funzionare anche per tutti i 
sottotipi Y di X. Rispettando 
questo principio siamo sicuri che 
nessuno possa utilizzare le nostre 
classi in modo improprio. 
Controllate che i metodi delle 



vostre classi non perdano di 
significato se ad essi vengono 
passati estensioni dei tipi presenti 
nella loro signature. 
DIP: Dipendency Inversion 
Principle, due classi concrete non 
dovrebbero mai avere dipendenze 
dirette, inoltre le interfacce non 
dovrebbero mai dipendere da 
classi concrete. Evitate le classi 
che hanno i parametri dei setters 
(o di un costruttore) che non 
siano interfacce, lo stesso di 
interfacce in cui compaiono classi 
concrete. 

SRP: Single Responsibility 
Principle, una classe dovrebbe 
aver un solo motivo per cambiare. 
Diffidate da classi con troppe 
linee di codice o che "fanno" 
troppe cose, non si dovrebbe mai 
concentrare più di una 
responsabilità nella logica di una 
classe. 
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sibility il significato di "motivo per cambiare". Le 
classi e le interfacce non dovrebbero essere cari- 
cate di troppe responsabilità, tutto ciò è molto uti- 
le quando si vanno a definire i moduli dei nostri 
progetti. Ritornando al problema presentato nel 
precedente paragrafo, possiamo certamente di- 
saccoppiare l'entità automobile dal modo con cui 
viene resa persistente. Anticipiamo che per semplicità 
e soprattutto per motivi di spazio, la soluzione che 
stiamo per presentare non è quella ottima e non 
rispetta del tutto uno dei principi (DIP) visti in pre- 
cedenza. 



e.printStackTrace(); 



} 



La classe FileDAO invece si occupa della persistenza su 
file di oggetti che implementano Serìalizable. Aven- 
do separato le responsabilità ed avendole affidate a 
due classi distinte abbiamo reso il nostro codice me- 
no sensibile ai cambiamenti. 



public class Automobile implements Serializable{ 
private String modello=null; 
private int cilindrataci; 



public int getCilindrataQ { 



return cilindrata; 



} 



public void setCilindrata(int cilindrata) { 



this. cilindrata = cilindrata; 



} 



public String getModelloQ { 



return modello; 



} 



public void setModello(String modello) { 



this. modello = modello; 



} 



Nella classe Automobile abbiamo confinato solo i me- 
todi che riguardano strettamente le caratteristiche di 
un'automobile. 

public class FileDAO { 

public Serializable carica(String fileName){ 
FilelnputStream fis=null; 
Serializable au=null; 

try { 

fis = new FilelnputStream(fileName); 
ObjectlnputStream ois = new Objectlnput 

Stream(fis); 
au=(Serializable)ois.readObject(); 
ois.closeQ; 
} catch (Exception e) { 
e.printStackTraceQ; 



UNA MOTO STRATEGICA 

Finora abbiamo imparato ad utilizzare i più im- 
portanti principi inerenti la programmazione 
OO. Vediamo cosa può succedere affrontando 
un nuovo problema ed utilizzando i principi ap- 
pena studiati. Supponiamo di voler realizzare un 
prototipo di moto per il quale è possibile fissare 
il mappaggio dell'erogatore a partire da un set 
di mappaggi predefiniti. Inoltre la nostra moto, 
in base all'erogatore adottato, calcola la velocità 
in base alla velocità corrente e al movimento 
esercitato dal pilota sull'acceleratore. Come pri- 
ma cosa definiamo un'interfaccia IMoto in mo- 
do da rispettare il principio OCP. Prima di vede- 
re l'interfaccia IMoto, stabiliamo di non con- 
centrare troppe responsabilità nella classe con- 
creta che implementerà IMoto; per questo motivo 
affidiamo il calcolo della velocità ad un Eroga- 
tore (SRP). Per evitare di avere una dipendenza tra 
la classe concreta Moto e la classe concreta Ero- 
gatore (DIP) introduciamo l'interfaccia IErogatore. 



public interface IMoto { 


public int getVelocita(); 


public void accelera(int deltaAcc); 


public void setErogatore(IErogatore 


erogatore); 


} 



Come possiamo notare la definizione di questa 
interfaccia ci aiuta a rispettare i principi appe- 
na discussi. In particolare la classe concreta che 
la implementerà utilizzerà un IErogatore per il 
calcolo della velocità. 



return au; 



} 



public void salva(String filelMame, Serializable ser){ 



FileOutputStream fos; 



try{ 



fos = new FileOutputStream(fileName); 
ObjectOutputStream oos = new Object 



OutputStrea m (fos) ; 



oos.writeObject(ser); 



oos.close(); 



} catch (Exception e) { 



public interface IErogatore { 



public int aggiornaVelocita(int deltaAcc,int velocita); 



} 



Questa interfaccia espone un solo metodo che 
calcola la velocità in base al delta di rotazione 
della manetta dell'acceleratore e alla velocità 
corrente. 

Una volta capito come funziona un generico ero- 
gatore, l'implementazione di una generica mo- 
to è molto semplice. 
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public class Moto implements IMoto{ 



private int velocita; 



private IErogatore erogatore=null 



public void accelera(int deltaAcc) { 



this. velocita 



this. erogatore. aggiornaVelocita(deltaAcc, 
this. velocita); 



public int getVelocita() { 



return this. velocita; 



public void setErogatore(IErogatore erogatore) { 



this.erogatore=erogatore; 



} 



Strale gy 



* accelera(deltaAcc : int) :void 

t- getVaelocitaO : int 

^ setErogatore(erogatore : Erogatore) :void 



ErogatoreDolce 



~velMAK:int=3l]0 



^ aggiornaVelocitaO : int 




Figura 3: Applicazione pratica dello Strategy Pattern 



Una volta istanziato un oggetto di tipo Moto, bisogna 
utilizzare il metodo setErogatore per utilizzare il tipo di 
erogatore che si preferisce. 

Per esempio una possibile implementazione di tale 
interfaccia potrebbe essere la seguente. 

public class ErogatoreDolce implements IErogatore{ 
int velMAX=300; 

public int aggiornaVelovita(int deltaAcc, int velocita) { 
int vel=0; 
if(deltaAcc!=0) 
vel=deltaAcc * 20+ velocita; 



else 



vel=velocita+5; 



if(vel>this.velMAX) 



vel=velMAX; 



return vel; 



} 



} 



Seguendo lo stesso approccio possono essere imple- 
mentati altri tipi di erogatori che implementano l'in- 
terfaccia IErogatore; nei sorgenti allegati nel CD è pos- 
sibile reperire le classi ErogatoreBrusco ed Erogatore- 
Medio. 



STRATEGY PATTERN 

A questo punto analizziamo il Class Diagram di 
questa soluzione. 

Il lettore più esperto avrà già capito che questo 
diagramma è noto al mondo informatico in quan- 
to rispecchia la definizione di un noto pattern: lo 
Stra tegy Pattern. 

Questo pattern consente la definizione di diver- 
si algoritmi (Concrete Strategy) intercambiabili 
tra loro ed appartenenti alla stessa famiglia (Stra- 
tegy). 
È ovvio che nel nostro caso il ruolo di Strategy è 



ricoperto dall'interfaccia IErogatore mentre i 
Concrete Strategy sono le sue implementazioni 
concrete (es: ErogatoreDolce). Inoltre la defi- 
nizione del pattern prevede un altro ruolo che 
è il Context. Esso è rappresentato dalla classe 
(nel nostro caso è la classe Moto) che si affida al- 
lo Strategy per l'esecuzione di un algoritmo. 



CONCLUSIONI 

In questo articolo abbiamo studiato i quattro 
principi che stanno alla base di una buona pro- 
grammazione Object Oriented. Inoltre abbia- 
mo visto che in alcuni casi la loro corretta ap- 
plicazione ci porta ad utilizzare i pattern più 
comuni in modo molto naturale. 
Va comunque detto che non sempre è possibi- 
le applicare alla lettera tali principi, a volte sia- 
mo alle prese con framework o moduli esterni 
che peccano da questo punto di vista, altre vol- 
te sono fattori esterni alla programmazione (sca- 
denze stringenti di progetto, o rilasci troppo 
ravvicinati) ad impedircelo. Il nostro consiglio 
è quello di applicare sempre questi principi e 
di utilizzarli soprattuto nel valutare l'esigenza di 
refactoring nel nostro software. 
L'idea di base è comunque che un'applicazio- 
ne non sia da considerarsi come statica ma co- 
me un elemento "vivo" a cui spesso saremo co- 
stretti ad apportare modifiche. Un buon pro- 
getto iniziale ed una struttura programmativa 
orientata alla gestione futura, se da un lato, ci co- 
stringerà ad una modalità iniziale più rigida, si 
rivelerà un elemento di successo per tutte le 
modifiche che avremo necesstà di apportare in 
futuro. 

Roberto Sidoti 
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GESTIAMO IN MODO 
SICURO LE STRINGHE 

NEL 1989 IL COMITATO ANSI AMMISE CHE SE IL C++ NON AVESSE AVUTO UN BUON 
SUPPORTO NATIVO PER LE STRINGHE SAREBBE "CORSO DEL SANGUE PER LE STRADE". 
COME E QUANTO FUNZIONANO GLI OGGETTI STRING, OGGI? 





REQUISITI 



■WJ.MJ.J.UA.'- 

,— Buona conoscenza del 

C++ 



A 



Un compilatore C++ 
standard 



00000 



Questa seconda parte è dedicata al text pro- 
cessing in C++. Nel primo appuntamento 
abbiamo visto quali strumenti mette a 
disposizione il C++ per la creazione e l'estrazione di 
dati nelle stringhe, considerando anche le soluzioni 
offerte da varie librerie e sistemi operativi, e termi- 
nando con qualche considerazione sull'internazio- 
nalizzazione. 

Così adesso sappiamo prendere dei dati e inserirli in 
una stringa senza mandare in crash il sistema. 
Purtroppo il lavoro del programmatore non si esau- 
risce qui: con le stringhe bisogna anche lavorarci! 
Quasi sempre ci si ritrova, ad esempio, a doverle 
manipolare in qualche modo: concatenando, inse- 
rendo, rimuovendo o prelevando caratteri o intere 
stringhe, oppure alterando le maiuscole, o elimi- 
nando gli spazi superflui. Possiamo aver bisogno di 
effettuare confronti: verificare, ad esempio, se una 
stringa contiene o meno un certo carattere o un'in- 
tera sottostringa. Oppure possiamo chiederci se due 
stringhe sono uguali, e in base a quale criterio. Ad 
esempio: "CIAO" è uguale a "ciao"? Dipende, se si fa 
o meno differenza fra maiuscole e minuscole. 
Infine, un programmatore può trovarsi di fronte alla 
necessità di verificare la validità del contenuto della 
stringa, controllando se essa aderisce o meno ad 
uno specifico modello formale. L'utente ha inserito 
un indirizzo e-mail, nella forma nome@dominio.it? 
Oppure: la sequenza inserita è un codice fiscale? 
E poi ci sono i casi più intricati. Il codice fiscale inse- 
rito corrisponde effettivamente ai dati di nascita, o 
l'utente si è inventato tutto? Per saperlo, occorre 
andare al di là della semplice struttura formale, 
interpretandone anche il significato. Per un codice 
fiscale è piuttosto semplice, dal momento che ha 
una struttura fissa, ma non è detto che sia sempre 
così. Un codice può essere formato da più espressio- 
ni innestate (quanto vale la stringa "2+2*(5-4)"?), 
fino ad arrivare ai veri e propri linguaggi (dai tag 
XML in su). Al momento, il C++ standard offre solu- 
zioni ottimali solo per alcuni di questi problemi, 
mentre per altri fatica un po', richiedendo al pro- 
grammatore qualche giro di troppo. I compiti più 
avanzati, poi, sono completamente fuori portata. 



In questa puntata partiremo dalle basi del linguag- 
gio per analizzare le possibilità attuali delle stringhe 
in C++. Ne sottolineeremo anche i limiti, dedicando 
tutto resto di questa miniserie a superarli, grazie al 
supporto di librerie esterne valide e compatibili. 
Oltre ad essere utilissime, molte soluzioni che vedre- 
mo faranno parte integrante di C++09, la prossima 
versione del C++. 



UHI APPROCCIO INGENUO 
ALLE STRINGHE 

Non si possono capire le soluzioni avanzate, se 
prima non si conoscono alla perfezione i meccani- 
smi di base del linguaggio. Sapete com'è definito 
internamente il tipo string? Se la risposta è no, 
seguite i prossimi paragrafi: vi aiuteranno a capire 
perché la STL è fatta così, e come funzionano le 
soluzioni che incontreremo in futuro. Facciamo 
finta di non conoscere nulla della definizione delle 
stringhe in C++, e di essere noi a realizzare la libreria 
standard. Dal momento che una stringa è un vetto- 
re di caratteri, potremmo definirla così. Che ne dite? 

typedef string std::vector<char>; 

Uno dei tanti vantaggi di questa scrittura sta nel 
fatto che è generica, e permette di definire anche 
stringhe di "caratteri" che non siano char. 

typedef wstring std: :vector<wchar_t>; 

È un punto importante: non vogliamo essere accu- 
sati di insensibilità verso tutte quelle culture che 
usano alfabeti e codifiche diversi dal nostro. Ma ciò 
crea un problema: caratteri diversi richiedono fun- 
zioni di valutazione, confronto, ricerca e manipola- 
zione diverse. Per questo potremmo pensare di defi- 
nire una classe astratta character: 

class std::character { 
public: 

character(int); //costruttore da intero 
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//confronti fra caratteri 



//definizione dei tipi 



virtual bool operator= = (const character& b) = 0; 
virtual bool operator<(const character& b) = 0; 



}; 



Character, poi, può essere ereditata dai tipi concreti 
che definiscono un singolo insieme di caratteri: 



class std: 


:ASCIIChar : public std:: character {...}; 


class std: 


:UnicodeChar : public std: :character {...}; 


class std: 


:ChineseChar : public std: :character {...}; 



E i tipi di caratteri ereditati, infine, possono utilizza- 
ti in vettori per creare delle stringhe. 

typedef std::ASCIIString std::vector<ASCIIChar>; 
typedef std::UnicodeString 

std: :vector<UnicodeChar> 



CHAR TRAITS 

Quello mostrato nel paragrafo precedente è un 
approccio possibile, ma il C++ non l'ha seguito, per 
almeno due buoni motivi. Il primo è l'efficienza: le 
funzioni virtuali sono più lente e le classi derivate 
devono memorizzare una vtable. Il secondo è di 
ordine pratico: dov'è finito il caro e vecchio char? 
Questo tipo di carattere esiste già, ed è quello che 
viene usato comunemente nella programmazione 
standard. Lo buttiamo via? L'approccio seguito dal 
C++, invece, è concettualmente molto simile a quel- 
lo appena visto, ma fa ricorso alla programmazione 
generica. Al posto di definire la classe base charac- 
ter, la STL usa il tipo char_traits. Vi state chiedendo 
dove sia la differenza? Sta nel fatto che charjraits è 
una classe template, ed è definita così: 

template<typename Character> struct charjraits {}; 

Badate che non ho scritto le parentesi graffe per dire: 
"qui va l'implementazione", charjraits è proprio 
definita così... una struttura vuota! Evidentemente, 
c'è sotto un trucco, che peraltro è molto usato nella 
programmazione C++ generica. Una classe traits, 
infatti, è un insieme (ma un esperto di metapro- 
grammazione la definirebbe dispregiativamente 
un'accozzaglia, o blob) di tipi e funzioni membro 
statiche che descrivono il tipo passato come para- 
metro. Char_traits, quindi, è vuota perché in sé non 
ha alcun'importanza: quelle che contano sono le sue 
specializzazioni. Per fare un esempio pratico, ecco 
un estratto di char_traits<char>: 

//specializzazione di charjraits per i char 
templateo struct char_traits<char> { 



typedef char char_type;//tipo di carattere 
typedef int int_type;//tipo intero corrispondente 
typedef streampos pos_type;//tipo di offset negli 

stream standard 



//... altre definizioni di tipo 



//funzioni di confronto fra caratteri. 



static bool eq(const char_type& a , const charjype& 

b); //a == b? 

static bool lt(const charjype& a , const charjype& 

b); // a < b? 



//... altre funzioni di confronto 



//funzioni su array. Esempi: 



static size_t length(const char_type* str); // quanto 

è lunga str? 
static int compare(const char_type* stri, const 

charjype* str2); //confronta due stringhe 



}; 



Come vedete, in questo estratto si definiscono dei 
tipi e delle funzioni membro statiche. Se char_traits 
è l'equivalente generico della classe base character 
che abbiamo visto sopra, char_traits<char> è l'equi- 
valente di ASCIICharacter. Tutte le altre specializza- 
zioni di charjraits per altri tipi di caratteri hanno lo 
stesso aspetto. Ad esempio: 

//specializzazione di charjraits per i wcharj 

templateo struct charjraits<wcharj> { 
//definizione dei tipi 

typedef char charjype; //tipo di carattere 
typedef int intJype;//tipo interocorrispondente 

//funzioni di confronto fra caratteri 
static bool eq(const charjype& a , const 

charjype& b); //a == b? 



E così via. 



BASIC STRIIMC 

Grazie a char Jraits, possono essere scritte funzioni 
e classi che si comportino diversamente a seconda 
del parametro passato. Siete di fronte a ciò che in 
gergo viene chiamato polimorfismo statico. Per 
sfruttarlo, occorre abbandonare l'idea di un vec- 
tor<char> e creare un nuovo contenitore che faccia 
riferimento internamente a charjraits. La STL lo 
chiama basic_string, e lo definisce così: 

template< 

typename Character, 

typename Traits = charJraits<Character>, 

typename Allocator = allocator<Character> 




"INSTALLARE" 
BOOST 

Per usare ciò che è 
spiegato in 
quest'articolo, non 
serve alcuna 
"installazione" 
particolare di boost. 
Basta scaricare i 
sorgenti da 
www.boost.org. e 
impostare le directory 
di inclusione nel 
proprio IDE (se ne si 
sta usando uno). 



"INSTALLARE" 
STRING ALGO 

Per usare gli string 
algorithm non è 
necessario col legare 
alcuna libreria. E' 
sufficiente avere 
impostato boost fra le 
directory d'inclusione, 
e includere il file 
"<boost/algorithms/str 
ing.hpp>". Per evitare 
di dover specificare 
sempre boost:: davanti 
a ogni funzione, è 
bene dichiarare, da 
qualche parte prima 
dell'uso, using 
namespace boost; 
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METAPRO- 
GRAMMAZIONE 

Se la spiegazione del 

funzionamento di 

char traits ha 

illuminato la vostra 

mente affacciandola a 

nuove vette di 

perversione, forse 

avete la stoffa dei 

metaprogrammatori 

template e non lo 

sapete ancora. Questa 

rubrica tratterà alcune 

tecniche di 

metaprogrammazione 

fra diversi numeri... 

nel frattempo potete 

leggere 

l'indispensabile "C++ 

Template 

Metaprogramming"di 

Dave Abrahams e 

Aleksey Gurtovoy. 



LEZIONI 

D'INCAPSULA- 
MENTO 

Se tutta quella storia 

sul "Preferire funzioni 

non membro non 

friend alle funzioni 

membro" non vi 

convince molto, è 

decisamente il caso di 

leggervi il Tema 

numero 23 di Effective 

C++ (3ed) di Scott 

Meyers. 



> class std::basic_string; 

Come vedete, il programmatore deve soltanto speci- 
ficare il tipo di carattere (indicato qui con Character) 
e, se esiste una specializzazione char_traits 
<Character>, basic_string sarà automaticamente in 
grado di accedere alle funzioni che abbiamo visto 
nel precedente paragrafo. Inoltre, se si vuole, è pos- 
sibile specificare un char_traits diverso e personaliz- 
zato (come vedremo fra poco). Per velocizzare le 
cose, la STL definisce anche i seguenti typedef: 

typedef std::string std::basic_string<char> 
typedef std::wstring std::basic_string<wchar_t> 



PERSONALIZZARE 
CHAR TRAITS 

È importante sapere che basic_string si basa, nelle 
sue operazioni fondamentali, su char_traits. 
Prendiamo il caso dell'operatore di confronto. 

std::string stringai = "Ciao", stringa2 = "CIAO"; 
std::cout << (stringai == stringa2); //Vero? Falso? 

Il codice qui sopra riprende la domanda posta nel- 
l'introduzione: "Ciao" e "CIAO" sono uguali? Basic_ 
string non risponde direttamente, ma lo chiede a 
char_traits. Perla specializzazione char_traits<char> 
della libreria standard la risposta è no. Il confronto è 
un'operazione case sensitive: fa differenza fra maiu- 
scole e minuscole. 

E se volessimo una stringa che non fa differenza fra 
maiuscole e minuscole? Basterebbe implementare 
un char_traits appropriato: 

struct chaMxaitsJndulgente : char_traits<char> { 
static bool eq(char ci, char c2) { 
return toupper(cl) == toupper(c2); 

} 

static int compare(const char* si, const char* s2, 

size_t n) { 
return memicmp(sl, s2, n); 
} 

}; 



tore virtuale è Male, ma in questi casi è consentito, 
dato che non abbiamo certo intenzione di usare 
char_traits_indulgente in modo polimorfico. 
Ora possiamo usare char_traits_indulgente per 
creare una strìnga_indulgente, così: 

typedef basic_string<char, 

char_traits_indulgente> stringajndulgente; 

E il gioco è fatto. La nuova stringa userà le funzioni 
di confronto "indulgenti", che non fanno differenza 
fra maiuscole e minuscole: 



stringajndulgente stringai = "ciao", stringa2 



"CIAO"; 



std::cout << (stringai == stringa2); //vero! 



BASIC STRING COME 
CONTENITORE STL 

Basic_string definisce costruttori, distruttore, opera- 
tore d'assegnamento, di uguaglianza, e di confronto. 
Inoltre, offre alcune funzioni membro ottimizzate 
per la gestione della stringa. Non bisogna mai 
dimenticare che basic_string offre tutte le possibilità 
di un contenitore STL: le funzioni pushjback e 
appendi), ad esempio, inseriscono degli elementi in 
coda. Insert inserisce dei caratteri in mezzo, erase li 
rimuove, e clear svuota tutto il buffer. Size (o length) 
restituisce il numero di caratteri della stringa e capa- 
city la reale dimensione corrente del buffer. Resize 
aumenta le dimensioni del buffer aggiungendo un 
carattere alla fine. E, ovviamente, [] e at possono 
essere usati per l'accesso casuale. 

string str("CIAO..."); //costruttore da char[] 



str.erase(4, 3); 



//str = "CIAO" 



str += "MONDO" 



//str = "CIAOMONDO" 



str.push_back(T); //str = "CIAOMONDO!" 
str.insert(4, ", "); //str = "CIAO, MONDO!" 
str.resize(14, '!'); //str = "CIAO, MONDO!!!" 



cout << str.lengthQ; 



//14 



cout << str.capacity(); 



//14 o più 



cout << str[15]; //comportamento indefinito 
cout << str.at(15); //eccezione out_of_range 



Il nuovo char_traits_indulgente deriva direttamente 
da char_traits, ridefinendo le funzioni di confronto 
fra caratteri (eq) e fra stringhe (compare). In que- 
st'ultima, usiamo la funzione memicmp, che non è 
standard ma è molto diffusa fra i migliori compilato- 
ri. Se seguite questa rubrica da un po', forse vi ricor- 
derete che abbiamo fatto qualcosa del genere qual- 
che numero fa, quando abbiamo definito un alloca- 
tole che usasse malloc derivando da allocator. 
Anche in questo caso ripeto lo stesso monito dell'al- 
tra volta: derivare da classi concrete prive di distrut- 



BASIC STRING 

E GLI ALGORITMI STL 

In quanto contenitore STL a tutti gli effetti, 
basic_string permette di accedere agli iteratori, e 
quindi è possibile utilizzare su un basic_string tutta 
la vasta gamma degli algoritmi previsti dalla libreria 
<algorithm> del C++: 

#include <iostream> 
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#include <string> 



#include <algorithm> 



using namespace std; 



bool SonoAnagrammi(const string& parolai, const 

string& parola2) { 



string firmal(parolal), firma2(parola2); 



sort(firmal.begin(), firma l.end()); 
sort(firma2.begin(), firma2.end()); 



return (firmai == firma2); 



int main(int argc, char **argv) { 



if (argc < 3) 



return EXIT_FAILURE; 



if (SonoAnagrammi(argv[l], argv[2])) 



cout << "I due termini sono 



anagrammi. \n" 



else 



cout << "Riprova. Sarai più' fortunato. \n"; 



return EXIT_SUCCESS; 



} 



L'esempio qui sopra mostra un piccolo programmi- 
no che verifica se due argomenti passati sono o 
meno l'anagramma l'uno dell'altro, per mezzo del- 
l'algoritmo sort. Sort ordina i caratteri in modo cre- 
scente, in modo da ottenere una "firma" di confron- 
to. Potete ben immaginare che questo è probabil- 
mente l'unico caso al mondo in cui avrà mai senso 
"ordinare" i caratteri di una stringa. È emblematico, 
purtroppo: anche se funzionano benissimo, spesso 
gli algoritmi STL non hanno molto senso se appli- 
cati alle stringhe. E anche quando hanno senso, 
spesso non sono molto ottimizzati. E anche quando 
sono ottimizzati, spesso hanno un aspetto molto 
"innaturale", (mi fermo qui.) (potrei continuare.) Per 
questo, basic_string ha delle funzioni membro spe- 
cifiche per implementare alcune operazioni comuni 
per i testi. 



CONVERSIONI 

A STRINGHE C-LIKE 

Fra le necessità specifiche di basic_string, c'è la con- 
versione dei dati. Alcune librerie di stampo C, infat- 
ti, non "capiscono" le stringhe C++, e hanno bisogno 
di un rozzo array di char. Basic_string implementa 
ben tre funzioni, per queste situazioni: data di acce- 
dere ad un array di caratteri, c_str una stringa "in 
stile C" a terminatore nullo, e copy copia l'array in 
un buffer già creato (senza terminatore). 



Tipicamente si usa c_str per chiamare le funzioni di 
libreria C, e copy per evitare di sprecare memoria 
inutilmente, nel caso si disponga di un array già 
creato. La funzione data è notoriamente poco utile, 
come mostra il seguente esempio: 

string str("Ciao, mondo!"); 

char stringa[20]; //buffer già esistente 

size_t lenStringa = str.copy(stringa, 5); //copia 

i primi 5 caratteri di str in stringa 
stringa[lenStringa] = '\0'; //aggiunge 

terminatore alla fine 
cout << stringa; //Ciao 



//stringa C-like 



cout << strlen(str.c_str()); //12 



//stringa non terminata 



cout << str.dataQ; //crash! :) 



FUNZIONI DI RICERCA 
DI BASIC STRING 

Infine, basic_string permette di reperire sequenze di 
caratteri all'interno della stringa - ovverosia delle 
sottostringhe. La funzione substr(partenza, nume- 
rocaratteri) è fatta apposta: 



string str("Ciao, mondo! 


'); 




cout << str.substr(6, 5); 


string str("www.ioprogrammo 


■it"); 


cout << str.find("."); 


//3 




cout << str.rfind(".") 


//15 




cout << str.find_first_ 


_not_of( 


'w."); //4 


cout << str.find_last_ 


of("z"); 


//npos 



L'ultima istruzione è interessante. Si richiede al C++ 
di ricercare l'ultima zeta presente nella stringa str. 
Solo che in str... non c'è nessuna zeta! In questo 
caso, il valore restituito sarà la costante npos {no 
position). Npos è impostato sul valore limite per il 
buffer di una stringa (-1, dato che un size_t è senza 
segno), e pertanto usarlo come indice è un errore, 
che genera un'eccezione di tipo range_error. 

string str("www. ioprogrammo.it"); 

cout << str[str.find_first_not_of("w.")]; //'i' 

cout << str[str.findJast_of("z")]; 

Una volta reperita una sottostringa, è possibile sosti- 
tuirla con un'altra, oppure rimuoverla del tutto (il 
che, alla fin fine, è un caso particolare di sostituzio- 
ne con una stringa vuota). Replace (inizio, numero- 
caratteri, sostituzione) permette di farlo. 



string str( 


www.ioprog 


'ammo.it 


); 


size. 


_t inizio = str.find(' 


.") + i; 




size. 


_t fine 


= str.rfind(" 


"); 




size. 


_t n = 


fine - inizio; 








STRING E STL 

Per tutti i dettagli su 
string e gli algoritmi 
STL, consultate un 
buon testo di 
riferimento. Il mio 
personalissimo 
preferito è "The C++ 
Standard Library, a 
tutorial and 
reference" di Nicolai 
Josuttis. 



CASE (ini) 

SENSITIVITY 

La creazione di un 
char traits case 
insensitive è trattata 
in varie fonti, e una 
delle migliori è 
senz'altro 

"Exceptional C++" di 
Herb Sutter. Nel Tema 
numero 2, si affronta 
la questione in 
profondità, e si 
risponde anche la 
domanda "è sicuro 
derivare da classi 
concrete, se non si 
intende usare il 
polimorfismo 
dinamico? [sì]", sulla 
base del Principio di 
Sostituzione di Liskov 
Generico. 
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str.replace(inizio, n, "robertoallegra"); 




BOOST? 

Un'ottima 

introduzione a Boost è 

il testo di Bjorn 

Karlssonn: "Beyond 

the C++ Standard 

Library". Nontratta 

alcuni argomenti, 

come gli string algo 

visti in questa 

puntata, ma fornisce 

informazioni in 

abbondanza su 

boost::regex, 

boost::range, 

e altri meccanismi 
fondamentali. 

QUALI 
STRINGHE? 

Se ci fate caso, la 

maggior parte degli 

algoritmi di 

string algo presentati 

qui non richiede 

necessariamente che i 

parametri passati 

siano di tipo 

basic string. Qualsiasi 

sequenza permetta di 

ottenere degli 

iteratori va bene: dagli 

array di char ai 

contenitori più esotici. 



cout << str; //www.robertoallegra.it 



I LIMITI DI BASIC STRING 
E BOOST:: STRI IMG ALGO 

Più o meno questo è tutto ciò che offre basic_string. 
È un punto di partenza, ma soddisfa molto poco le 
esigenze del programmatore medio che abbiamo 
riassunto a inizio paragrafo. Manca del tutto il sup- 
porto per alcune operazioni fondamentali, come la 
conversione in maiuscolo o in minuscolo, l'elimina- 
zione degli spazi, la ricerca avanzata di sottostrin- 
ghe. È possibile costruire facilmente delle funzioni 
che si occupino di farlo, ed è per questo motivo che 
è giusto che queste non siano inglobate in 
basic_string, seguendo l'inviolabile Regola Di Stile 
che vuole che si preferiscano le funzioni non mem- 
bro non friend definite esternamente alla classe, alle 
funzioni membro. Il problema è che queste funzioni 
non membro non friend eccetera... non ci sono! 
Che state facendo? Aspettate un attimo, prima di 
buttarvi sulla tastiera a scriverne un'implementazio- 
ne fai-da-te. . . Pavol Droba si è buttato sulla tastiera 
prima di noi, e ha scritto un'implementazione di 
tutti gli algoritmi relativi alle stringhe che mancava- 
no nella STL. L'ha presentata alla comunità di Boost, 
questa l'ha passata al setaccio, e infine l'ha adottata, 
inserendola nell'header <boost/algorithm/string. 
hpp>. L'implementazione interna di queste funzioni 
è piuttosto complessa, e utilizza trucchi di metapro- 
grammazione tìpici di Boost per semplificare la vita 
al programmatore finale. Nel resto di quest'articolo 
vedremo alcune delle possibilità offerte da questi 
algoritmi, rimandando ai prossimi appuntamenti (e 
alla documentazione di boost) per quelli più avan- 
zati. 



MAIUSCOLO, MINUSCOLO, 
E BOOST::RAIMGE 

Uno dei buchi più sorprendenti della STL è la man- 
canza di un algoritmo per la conversione dal minu- 
scolo al maiuscolo e viceversa. È vero che il C++ defi- 
nisce in <locale> le funzioni toupper e tolower, ma 
queste lavorano solo su singoli caratteri! Potremmo 
scrivere la funzione da noi senza scomodare boost, 
ricordandoci che una stringa è un contenitore STL a 
tutti gli effetti: 

#include <locale> 
#include <algorithm> 
template<typename Iterator> 

inline void to_upper(Iterator begin, Iterator end) { 
transform(begin, end, begin, toupper); 

} 



Questa funzione svolge onestamente il suo lavoro, e 
infatti possiamo usarla facilmente: 

string str = "www.ioprogrammo.it"; 

to_upper(str.begin(), str.endQ); 

cout << str; //WWW.IOPROGRAMMO.IT 

Internamente, la funzione boost::to_upper (così 
come boost: :to_lower) è implementata più o meno 
allo stesso modo, ma rende le cose più semplici al 
programmatore, grazie ad una magia chiamata 
boost::Range. Grazie a Range è possibile passare 
semplicemente il contenitore, al posto dei due itera- 
tori - che nel 99% dei casi sono i soliti begined end). 

#include <boost/algorithm/string.hpp> 
string str = "www.ioprogrammo.it"; 
boost: :to_upper(str); 



cout << str; 



//WWW.IOPROGRAMMO.IT 



Se ci si trova nel restante 1% dei casi, e si ha un 
effettivo bisogno di indicare una parte della 
stringa, si può sempre creare un iterator_range, 
passando i due estremi come argomenti del suo 
costruttore: 

string str("www.ioprogrammo.it"); 
size_t inizio = str.find(".") + 1; 
size_t fine = str.rfind("."); 
iterator_range<string: :iterator> ioprogrammo( 



str.beginQ + inizio, 



str.beginQ + fine 



); 



boost: :to_upper(ioprogrammo); 



cout << str; //www.IOPROGRAMMO.it 

L'iterator_range va costruito prima della chiamata, e 
per questo la scrittura può rivelarsi un po' prolissa 
(ma più chiara). Ma in quanti casi avrete bisogno di 
rendere maiuscola solo una porzione della stringa? 



ALGORITMI PER COPIA 
E STD::BACK INSERTER 

Molti algoritmi esposti dalla libreria boost:: 
string_algo sono forniti almeno in due forme: in 
place e per copia. La cosa non è affatto nuova, dal 
momento che anche tanti algoritmi STL esistono in 
due o più forme. Si pensi ad esempio a std::replace, 
che sostituisce gli elementi compresi fra due iterato- 
ri. Esiste anche std::replace_copy, che non tocca l'o- 
riginale, ma crea una sequenza con gli elementi già 
sostituiti. La libreria boost segue la stessa conven- 
zione: esiste boost::to_upper, che converte una 
stringa in maiuscolo, ed esiste boost::to_ 
upper_copy, che copia la stringa passata in una 
nuova, trasformata in maiuscolo. A dirla tutta, esi- 



^ 100 /Maggio 2007 



http://www.ioprogrammo.it 



096-101 28-03-2007 15:20 Pagina 101 



Sviluppiamo software a prova di Hacking ■ T SISTEMA 



stono ben due versioni di to_upper_copy, a seconda 
delle esigenze. La prima è quella facile, che prende 
una stringa e ne restituisce una copia trasformata: 

string str("www. ioprogrammo.it"); 

string str2(to_upper_copy(str)); 

cout << str2; //WWW.IOPROGRAMMO.IT 

Poi c'è il caso più complicato, analogo a quell'1% 
che abbiamo visto nel paragrafo precedente, in cui si 
desidera effettuare una copia di un raggio ridotto di 
una stringa di partenza. In questi casi, si usa la ver- 
sione to_upper_copy(IteratoreCopia, Range 
Originale), laddove Iterato reCopia è tipicamente un 
inseritore. L'uso e il funzionamento degli inseritori è 
noto a chiunque abbia un po' di esperienza nella 
programmazione per algoritmi C++. Se non siete 
pratici, potete vedere back_inserter(stringa) come 
una funzione magica che restituisce un iteratore 
ancor più magico, capace di inserire elementi diret- 
tamente in stringa. 

string str("www. ioprogrammo.it"); 

string str2; 

size_t inizio = str.find(".") + 1; 

boost::to_upper_copy(back_inserter(str2), 

ioprogrammo); 
cout << str2; // WWW.IOPROGRAMMO.IT 

È una procedura un po' prolissa, ma quante volte 
vorrete creare una nuova stringa a partire da una 
porzione di quella originale? 



TRirvlMIIMC 

Un'altra mancanza della STL è una funzione specifi- 
camente destinata al trimming. In un mondo perfet- 
to non ci sarebbe bisogno di eliminare gli spazi 
superflui, ma il nostro è decisamente imperfetto: 
per colpa dell'utente o del sistema (o di un'associa- 
zione a delinquere fra i due) capita spesso di trovare 
delle povere stringhe strette, da un lato o da entram- 
bi, fra la morsa di una comitiva di spazi inutili. 
È certamente possibile organizzare una funzione 
di trimming usando find_first_not_of (per trova- 
re il primo carattere sinistro che non sia uno spa- 
zio) e find_last_not_of (per il lato destro), ma non 
ce n'è bisogno. Boost::String_algo si occupa 
anche di questo, mediante le funzioni trim, 
trim_left, e trim_right. Tutti i sistemi già visti per 
to_upper e to_lower si applicano anche alle fun- 
zioni di trimming: i range, le funzioni di copia, gli 
inseritori. 

string str(" www.ioprogrammo.it "); 
string str2(trimJeft_copy(str)); //str2 = 

"www.ioprogrammo.it " 



string str3(trim_right_copy(str)); //str3 = " 

www.ioprogrammo.it" 



str.trimO; 



//str = "www.ioprogrammo.it" 



A volte, a dare fastidio non sono soltanto gli 
spazi, ma anche altri caratteri: tabulazioni, 
punti, asterischi, zeri, e così via. Le funzioni di 
trimming trim_left_if, trim_right_if trim_if di 
specificare un predicato per l'identificazione dei 
caratteri da tagliare: 



string str("../../ 


./ioprogram 


mo/"); 












string str2 = 


'C:/' 


+ trim 


_copy_ 


jf(str, 


is_ 


_any_ 


_of(' 


■/")); 


// cout << str2; 



Nel codice qui sopra abbiamo un indirizzo relati- 
vo pieno di punti e slash, e vogliamo trasformar- 
lo in uno assoluto Indichiamo quindi di elimina- 
re ogni carattere '.' o 7' che compaia agli estremi 
della stringa. 



PREDICATI 
E BOOST::ALL 

Ma da dove è saltata fuori la funzione is_any_ofdel- 
l'ultimo esempio? È un predicato. Niente di nuovo 
sotto il sole: la STL è piena di algoritmi_if che richie- 
dono predicati. Is_any_of è uno dei tanti messi a 
disposizione da boost::string_algo, e restituisce true 
un carattere corrisponde a quelli indicati. I predica- 
ti vengono usati dalle funzioni_if come trim, o come 
ali, che verifica se un dato predicato è soddisfatto 
per ogni carattere della stringa: 

//contiene solo cifre? 

cout << all("IoProgrammo 114", is_digit()); //falso 

cout << all("114", is digit()); //vero 

cout << all("IoProgrammo 114", is_alpha()); //falso 
cout << all("IoProgrammo", is_alpha()); //vero 
cout << all("accada", is_from_range('a', 'd')); //vero 
cout << all("avvenga", is_from_range('a', 'd')); //falso 



CONCLUSIONI 

Abbiamo cominciato questo articolo dalle fon- 
damenta del linguaggio e ci ritroviamo già ad uti- 
lizzare una libreria avanzata come boost: 
:string_algo. 

Molte necessità devono ancora essere soddisfat- 
te, e molte soluzioni devono ancora essere rivela- 
te. Appuntamento al mese prossimo, in cui fare- 
mo un salto in avanti nella libreria string_algo (e 
in altre più avanzate), scoprendo strumenti 
ancor più sofisticati. 

Roberto Allegra 





Il sito www.roberto 
alleqra.it contiene 
l'elenco degli articoli 
pubblicati in questa 
rubrica, con gli 
inevitabili 

approfondimenti ed 
errata corrige. L'e-mail 
dell'autore è 
articoli@roberto 
allegra.it. 
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L'ADAPTER: METTE 
TUTTI D'ACCORDO 

I MIGLIORI PROGRAMMATORI LAVORANO SPESSO ASSEMBLANDO LIBRERIE E FRAMMENTI 
DI CODICE SCARICATI DA INTERNET DI SOLITO QUESTI PEZZI NON SONO PENSATI 
PER FUNZIONARE INSIEME. MA PER FORTUNA, C'È MODO DI RISOLVERE IL PROBLEMA. 




E 1 
! 
1 



LI CD J WEB 

adapter_codice.zip 



^ 



F7 ^ ■ ' ' 



venerdì. E Salvatore, il preoccupato pro- 
grammatore, sa che il suo fine settimana è in 
1 pericolo. Questa mattina il capo è apparso, 
silenzioso come un ninja, per chiedere alcune in- 
nocenti modifiche all'applicazione gestionale per 
il Club dei Ricchi cittadino. Il responsabile com- 
merciale ha già venduto le modifiche senza con- 
sultare i tecnici, e ha promesso che il tutto sareb- 
be stato pronto entro lunedì. Salvatore si mette al 
lavoro sospirando. Aveva ragione sua madre: avreb- 
be dovuto fare l'avvocato. 



IL CLUB DEI RICCHI 

Il Club dei Ricchi si basa su un semplice principio: cia- 
scun nuovo socio deve essere presentato da un socio 
già esistente, che da quel momento in poi diventa il 
suo responsabile. Se un socio si comporta in modo 
sconveniente (ad esempio sbevazza contenuto del- 
lo sciacquadita, o racconta una barzelletta da camio- 
nisti durante il ricevimento della Contessa Serbello- 
ni) , il suo responsabile subisce una sanzione discipli- 
nare. 

L'azienda di Salvatore, il preoccupato program- 
matore, ha sviluppato per il club una semplice ap- 
plicazione in Ruby. Ecco la classe che identifica 
un socio: 

class Member 
attr_reader :name, :surname, :introduced_by 



il suo cognome e la persona che l'ha presentato, 
che sarà a sua volta un Member. Se quest'ultimo 
argomento ha un valore nullo (nil), allora socio non 
ha un responsabile, ed è dunque il fondatore del 
club. 

I tre argomenti di initializeO vengono conser- 
vati in altrettante variabili di istanza (Ruby le 
chiama "variabili di istanza", ma se preferite po- 
tete chiamarle "campi"). In Ruby, le variabili di istan- 
za si riconoscono perché hanno una "@" come 
prefisso. Come per le normali variabili, non c'è bi- 
sogno di dichiarare le variabili di istanza: na- 
scono immediatamente la prima volta che gli si 
assegna un valore. 
In conclusione, posso creare un fondatore così: 

piergigi = Member.new("Piergigi", "Rossi", nil) 

Quando chiamo new() sulla classe Member, Ruby 
crea un'istanza della classe e la inizializza chia- 
mando initializeO- In questo caso abbiamo crea- 
to un socio fondatore assegnando un valore nul- 
lo a introduced_by. Tipicamente, dobbiamo dare 
un responsabile al nuovo socio: 

pieruga = Member.new("Pieruga", "Verdi", gino) 

Le variabili di istanza in Ruby sono sempre private. 
Quindi non posso leggerle direttamente: 

piergigi. @surname # Errore! 



fi 




REQUISITI 



Conoscenze richieste 



,—" Programmazione a 
LJ. oggetti 



Un qualsiasi linguaggio 
di programmazione 
object-oriented. 




def initialize(name, surname, introduced_by) 



@name = name 



@surname = surname 



@introduced_by = introduced_by 



end 



end 



Anche se non conoscete Ruby, non dovrebbe es- 
sere difficile capire questo codice. Ignorate per il 
momento la riga che inizia con attrjreader. Il me- 
todo initializeO è l'equivalente Ruby di un co- 
struttore. Accetta tre argomenti: il nome del socio, 



La riga della classe Member che inizia con attrjreader 
definisce però tre proprietà in sola lettura che hanno 
gli stessi nomi delle tre variabili di istanza (senza il pre- 
fisso "@"), e le lega automaticamente alle variabili di istan- 
za. Quindi posso scrivere: 

puts piergigi. surname 

puts è l'istruzione per stampare sullo schermo. Que- 
sta riga di codice stampa: 

Rossi 
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muovi RICCHI 

Grazie alla recente speculazione edilizia, il club ha ri- 
cevuto un costante influsso di nuovi membri. Con tan- 
ta gente in giro, non è sempre facile capire chi sia re- 
sponsabile di chi. Quindi i gestori del club ci hanno 
chiesto di implementare una visualizzazione ad al- 
bero che mostra tutti i soci. Ciascun nodo dell'albero 
è un socio, e i suoi "figli" sono i soci di cui è responsa- 
bile. La radice è il fondatore del Club, che non ha alcun 
responsabile. Ad esempio: 

Giangigi Rossi 
Pieruga Verdi 

Piermalloppo Gialli 

Filiberto Magenti 
Giorgiarmando Bianchi 



end 




# seguono i metodi per visualizzare 


'albero su 


# una pagina web, eccetera 


end 



Salvatore sa che non ha bisogno di entrare nei detta- 
gli di questa classe. Si tratta di un solido prodotto open 
source, e gli serve solo capire come usarla. Il nostro 
baldo programmatore esamina rapidamente i meto- 
di principali di TreePanel: 

def initialize(root) 

raise "Not a root" if root.parent 

(cpnodes = [root] 
end 




Questa visualizzazione indica che il fondatore Rossi 
è responsabile di Verdi e Bianchi. A sua volta, Verdi è re- 
sponsabile di Gialli e Magenti. Per complicare le co- 
se, la visualizzazione ad albero deve funzionare su al- 
meno tre interfacce diverse: una semplice visualizza- 
zione testuale come quella qui sopra, una visualizza- 
zione interattiva simile a quella di un file system, e una 
pagina web. 

È impossibile pensare di scrivere tutta questa roba en- 
tro oggi. Ma Salvatore, l'eroico programmatore, non 
si perde d'animo: gli basta una breve ricerca su Inter- 
net per trovare una classe di nome TreePanel che ge- 
nera automaticamente tutte le interfacce "ad albero" 
che gli servono. 

class TreePanel 
def initialize(root) 
raise "Not a root" if root.parent 



(cpnodes = [root] 



end 



def add(node) 



raise "No such parent" if !@nodes. include? 



node.parent 



(cpnodes << node 



end 



def show 



show_subtree(@nodes[0]) 



end 



private 



def show_subtree(node, depth = 0) 



puts ' 



depth + node.to_s 



children_of(node).each {|child| show_subtree(child, 

depth + 1) } 



end 



def children_of(node) 



(cpnodes. find_all {|n| n. parent == node } 



Il "costruttore" di TreePanel riceve un nodo che 
diventa la radice dell'albero. Questo codice chie- 
de al nodo quale chi sia suo padre leggendo la 
proprietà parent. Se parent esiste, cioè se non è 
nil, allora il nodo non può essere usato come ra- 
dice, e il codice solleva un'eccezione (in Ruby, 
come in Perl, si può mettere l'if dopo la condi- 
zione anziché prima) . Il metodo initializeQ de- 
finisce anche una variabile di istanza @nodes, 
un array che conterrà tutti i nodi dell'albero, con 
la radice in prima posizione. 



def add(node) 


raise "No such 


parent' 


if 


!@nodes 


include? node 


parent 


(cpnodes << node 


end 



Questo metodo aggiunge un nodo all'albero. Se 
qualcuno cerca di aggiungere un nodo il cui padre 
non è già nella lista dei nodi registrati, la prima ri- 
ga lancia un'eccezione (un nuovo socio deve es- 
sere presentato da qualcuno che è già socio, non 
da uno sconosciuto) . La seconda riga aggiunga il nuo - 
vo nodo all'array dei nodi. 

def show 

show_subtree(@nodes[0]) 
end 

show() chiama un metodo privato, show_subtree(), 
che stampa un intero sotto-albero a partire da un sin- 
golo nodo. Salvatore non si preoccupa di capire bene 
come funziona show_subtreeQ. Gli basta sapere che 
show() passa a show_subtree() il nodo radice, stam- 
pando così l'intero albero. 

Per concludere, Salvatore dà uno sguardo al metodo pri- 
vato children_of, usato da show_subtree: 

def children_of(node) 

@nodes.find_all {|n| n. parent == node } 
end 
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Questo metodo usa qualche magico trucco Ruby 
per trovare tutti i figli del nodo dato, esaminan- 
do tutti i nodi dell'albero e chiedendo a ciascu- 
no chi sia suo padre. Questo è sicuramente un 
modo inefficiente per trovare i figli di un nodo, ma 
per un piccolo albero è accettabile. Questa clas- 
se manipola degli oggetti che sono nodi dell'al- 
bero, e vuole che questi oggetti abbiano una de- 
terminata interfaccia. In particolare: 

- initializeO, add() e childrenjofQ vogliono che cia- 
scun nodo abbia una proprietà parent che rappre- 
senta il suo nodo padre. 

- show_subtree() stampa ciascun nodo sullo scher- 
mo. In Ruby, questo significa che ciascun nodo de- 
ve avere un metodo to_sQ che restituisce la sua rap- 
presentazione come stringa. 



downloadFolder.parent = root 



musicFolder.parent = downloadFolder 



videosFolder. parent = downloadFolder 

Infine, il test costruisce il TreePanel e lo mostra sullo scher- 
mo: 



panel = TreePanel. new(root) 



panel. add downloadFolder 



panel. add musicFolder 



panel. add videosFolder 



panel. show 

Notate che le parentesi nelle chiamate ai metodi sono 
opzionali in Ruby, e Salvatore ha usato questa caratteristica 
del linguaggio per risparmiare un po' di codice. Ecco 
il risultato: 



Salvatore sa che il modo migliore per capire un pezzo 
di codice è usarlo, quindi scrive una classe di test che 
soddisfa queste due condizioni e finge di essere una di- 
rectory sul disco: 



download 



music 



videos 



class Directory 



attr_accessor : parent 



def initialize(name) 



Sembra che la classe funzioni bene. Salvatore deve so- 
lo integrarla nel sistema. A questo punto, però, sorge 
un problema. 



end 



def to_s 



end 



end 



attr_accessor funziona come attr_reader, ma defini- 
sce una proprietà di lettura e scrittura. Questo signifi- 
ca che non solo posso leggere il parent di un nodo, ma 
posso anche assegnargli un valore: 

figlio. parent = padre 

Questo soddisfa la prima condizione attesa da 
TreePanel. Inoltre Node accetta un nome nel suo 
costruttore, e questo nome è lo stesso che viene 
restituito dal metodo di conversione in stringa 
to_s(). Questo soddisfa la seconda condizione. 
Il test di Salvatore usa questa classe per testare il 
TreePanel costruendo un finto albero di direc- 
tory: 

root = Directory.new("c:") 
downloadFolder = Directory.new("download") 
musicFolder = Directory.new("music") 
videosFolder = Directory. new("videos") 

Dopo aver creato i nodi dell'albero, test li lega insie- 
me: 



DUE INTERFACCE 
E DUE MISURE 

Il sistema gestionale del Club dei Ricchi tratta 
oggetti di tipo Member. Ma questi oggetti non 
soddisfano le condizioni attese dal TreePanel: 
non hanno un parent, né un to_s0- Quindi non pos- 
so usare un Member come nodo di un TreePa- 
nel. 

Si potrebbe risolvere il problema aggiungendo 
le caratteristiche mancanti alla classe Member. Ma 
se aggiungere un metodo to_s() sembra un'idea 
sensata, aggiungere una proprietà parent vuol 
dire inquinare il codice di Member. Un Member 
deve essere usato in molte circostanze diverse, 
e non è il caso che questa classe sappia di esse- 
re anche un nodo dell'albero. 
In alternativa si potrebbe modificare TreePanel per- 
ché legga la proprietà introduced_by anziché pa- 
rent, ma anche in questo caso si tratterebbe di 
un brutto hack. La classe TreePanel dovrebbe 
trattare qualsiasi nodo, non solo i Member. Inol- 
tre, diventerebbe difficile aggiornare TreePanel 
quando il suo autore ne rilascerà una nuova ver- 
sione. Il fatto è che TreePanel e Member vivono su 
piani diversi: la prima classe fa parte della pre- 
sentazione, la seconda del modello business. 
Non avrebbe senso cablare una delle due classi 
per andare incontro alle esigenze dell'altra. 
Quello che ci serve è un traduttore, qualcuno che 
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renda comprensibili i Member al TreePanel. Que- 
sto è il lavoro del pattern Adapter. 



IL PATTERN ADAPTER 

Pensate a quante volte, quando volete collegare un di- 
spositivo elettrico alla presa, vi accorgete che lo stan- 
dard della presa nel muro è diverso da quello della spi- 
na. Quello che si fa in questi casi è cercare un adatta- 
tore. 

La stessa cosa succede con il codice: il client parla ad 
una certa interfaccia, ma gli oggetti che vogliamo pas- 
sargli hanno un'interfaccia diversa. Anche in questo ca- 
so ci serve un oggetto che faccia da adattatore. Il client 
parla all'adattatore, che traduce le chiamate verso l'og- 
getto adattato. 

Salvatore, l'astuto programmatore, scrive quindi una 
classe MemberNode con due caratteristiche: 

- MemberNode si comporta come un nodo, in modo 
che TreePanel possa usarlo tranquillamente. Questo 
significa che MemberNode ha una proprietà parent 
e un metodo to_s0- 

- MemberNode contiene un Member, e delega a lui 
tutte le operazioni che riguardano il modello. 

class MemberNode 
def initialize(member) 

@member = member 
end 

def parent 

©member. introduced_by 
end 

def to_s 

@member.name + " " + @member.surname 
end 
end 



creare ciascun nodo e "avvolgerlo" in un Adapter: 

giangigi = MemberNode. new(Member.new("Giangigi", 

"Rossi", nil)) 
pieruga = MemberNode. new(Member.new("Pieruga", 

"Verdi", giangigi)) 

giorgiarmando = 

MemberNode. new(Member.new("Giorgiarmando", 
"Bianchi", giangigi)) 
piermalloppo = 
MemberNode. new(Member.new("Piermalloppo", "Gialli", 

pieruga)) 
filiberto = MemberNode. new(Member.new("Filiberto", 

"Magenti", pieruga)) 

Ora possiamo creare il TreePanel, aggiungergli i nodi 
"adattati" e stampare l'albero: 




panel 


= TreePanel. new(giangigi) 


panel 


add pieruga 




panel 


add giorgiarmando 






panel 


add piermalloppo 




panel 


add filiberto 




panel 


show 





Il risultato è: 

Giangigi Rossi 



Pieruga Verdi 



Piermalloppo Gialli 



Filiberto Magenti 



Giorgiarmando Bianchi 



Client 




Adapter 




Adattato 










operazioneAdattataQ 







MemberNode incapsula un Member che gli viene 
passato in costruzione e lo trasforma in un oggetto 
manipolabile da TreePanel. Come la classe di te- 
st Node, anche MemberNode ha una proprietà 
di nome parent, il cui valore è lo stesso della pro- 
prietà introduced_by del Member incapsulato. 
In realtà parent è un metodo, ma in Ruby non ci 
sono vere differenze tra proprietà e metodi: pos- 
so chiamare parent senza usare le parentesi, che 
è quello che succede nel codice di TreePanel. 
MemberNodeha anche un metodo to_s() che tra- 
sforma l'oggetto in una stringa. Questo metodo 
concatena semplicemente il nome e il cognome 
del Member incapsulato. 

Ora possiamo scrivere un test che mette insie- 
me il client {TreePanel), l' Adapter {MemberNo- 
de) e l'oggetto Adattato {Member). Dobbiamo 



Funziona! 

VARIAZIONI SUL TEMA 

MemberNode è una classe completamente se- 
parata da Member. Però incapsula un Member, 
e delega a lui la maggiore quantità possibile di 
operazioni. Quindi il legame tra un MemberNo- 
de e un Member avviene a livello di oggetti. Per 
questo motivo, questa versione del pattern si 
chiama anche Object Adapter. 
Esiste una variante dello stesso pattern in cui la 
classe dell'Adapter eredita dalla classe dell'A- 
dattato: 

class MemberNode2 < Member 



http://www.ioprogrammo.it 



Maggio 2007/ 105 ► 



102-106 28-03-2007 15:47 Pagina 106 



PATTERN T Un adattatore universale 




def parent 


introduced_ 


_by 


end 


def to_s 


name + " ' 


+ surname 


end 


end 



Adattato 



o pe raz io neAd attata () 



Client 




Ad a p ter 



operazioneQ 



SE CE IL COMPILATORE DI MEZZO 



Il pattern Adapter è 
particolarmente adatto ai 
linguaggi staticamente tipati. I 
linguaggi dinamici come Ruby ci 
costringono a guardare nel codice 
per ricostruire le interfacce a cui 
"adattarci", in un linguaggio 
statico come Java le interfacce 
sono dichiarate esplicitamente. 
Una versione Java del TreePanel 
parlerebbe probabilmente ad 
un'interfaccia Node. Il nostro 
MemberNode dovrebbe quindi 
non solo includere un Member (se 
si tratta di un Object Adapter), ma 
anche implementare Node: 



Node. 



public class MemberNode implements 



Lo stesso vale per un Class 
Adapter: MemberNode! dovrebbe 
ereditare da Member ed 
implementare Node: 

public class MemberNode2 extends 

Member implements Node... 

Ecco che aspetto ha un Class 
Adapter in un linguaggio 
staticamente tipato. Il Target è 
l'interfaccia alla quale il client 
vuole parlare, nel nostro caso 
Node: 



Client 



Target 



operazione () 



Adapter 




Adattato 








operazione() 


* 


o pe ra z io ne Ad atta ta () 



Dato che un MemberNode2 è un Member, può 
accedere direttamente alle proprietà del Member 
(ed eredita anche il suo metodo initicdizeO) ■ Que- 
sto semplifica molto il codice dell'Adapter. Sem- 
plifica anche il codice del client. Anziché creare 
un nodo e poi usarlo per creare l'Adapter, il client 
può semplicemente creare TAdapter: 

giangigi = MemberNode2.new("Giangigi", "Rossi", nil) 
pieruga = MemberNode2.new("Pieruga", "Verdi", 

giangigi) 
giorgiarmando = MemberNode2.new("Giorgiarmando", 

"Bianchi", giangigi) 
piermalloppo = MemberNode2.new("Piermalloppo", 

"Gialli", pieruga) 
filiberto = MemberNode2.new("Filiberto", "Magenti", 

pieruga) 

Questa variante del pattern si chiama Class Adap- 
ter. 

Nel nostro caso, un Class Adapter ci permette di 
risparmiare codice. A volte, però, un Object Adap- 
ter è più flessibile. Ad esempio un Object Adap- 
ter ci permette di "avvolgere" non solo un Mem- 
ber, ma anche un oggetto di una sottoclasse di 
Member. Se Member avesse molte sottoclassi, ci 
servirebbe un Object Adapter per avvolgerle tut- 
te senza scrivere un Adapter specifico per cia- 
scuna. Come sempre, non esistono ricette buo- 
ne per tutte le circostanze. La scelta sta a voi. 
Quanto a Salvatore, anche per questa volta il suo 
fine settimana è salvo. 



CONCLUSIONI 

Il pattern Adapter è utile in molte circostanze. 
Come abbiamo visto, è la soluzione ideale per 
collegare pezzi di codice scritti da autori diversi. 
Ma non solo: spesso ha senso usare un Adapter 
anche se abbiamo il controllo sia del client che del- 
l'oggetto adattato, ad esempio per separare diversi 
pezzi della nostra architetture. Probabilmente 
avete già usato questo pattern per scopi simili 
in passato, anche se magari non gli avete dato 
un nome. Ovviamente questo tipo di "adattato- 
re" fa in modo di poter riunire sotto un unico 
cappello software che in teoria non potrebbe co- 
municare. In questo modo ci assicuriamo che 
eventuali framework, spezzoni di codice, ap- 
punti, siano sempre integrabili e velocizziamo 
di molto il nostro lavoro. D'altra parte il princi- 
pio base della programmazione è la riusabilità. 
Nei prossimi numeri affronteremo ancora argo- 
menti legati ad un principio teorico come i pat- 
tern, che però hanno un risvolto decisamente 
pratico 

Paolo Perrotta 
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SUL CD 



Virtual Box 1.3.8 



ILVIRTUALIZZATORE FREE 

ILa virtualizzazione è l'ultima fron- 
tiera. La nutrita schiera di sistemi 
operativi con le relative versioni, 
rende particolarmente complesso lo 
sviluppare programmi in grado di 
funzionare sui vari sistemi senza 
problemi. Per questo ogni program- 
matore tende a testare le proprie 
applicazioni su più sistemi. E' ovvia- 
mente quasi impossibile disporre di 
tante macchine per quanti sono i 
sistemi operativi così ci vengono in 
aiuto i software di virtualizzazione 
che emulano il comportamento di 
una macchina via software. 



% 






Virtual Box 



¥ 




VirtualBox è uno di questi. È recen- 
te, è molto leggero ed è free. 

virtualbox/VirtualBox 
1.3.8_Win_x86.msi 



APACHE 2.2.4 

IL WEB SERVER PIÙ USATO AL 
MONDO 

L'ultima versione del Web Server proget- 
tato da Apache e che da solo tiene in piedi 
una buona parte di Internet. Nonostante 
l'agguerrita concorrenza Apache rimane 
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potete fare a meno di avere installato 
sulla vostra macchina in locale una ver- 
sione di Apache. Quella che vi presentia- 
mo è la versione 2.3 della serie 2, che 
ormai è sufficientemente consolidata da 
essere usata in ambienti di produzione. 
Apache/apache 2.2.3-win32-x86-no ssl 

IRRLICHT 1.2 

ACCENDI IL MIGLIORE MOTORE 3D 
OPEN SOURCE! 

Irrlicht è un motore per la grafica tridi- 



un Web Server incredibilmente usato. I 
suoi moduli sono praticamente illimitati, 
è incredibilmente leggero.viene utilizzato 
praticamente su tutte le piattaforme di 
hosting al mondo. Se avete in mente di 
progettare un'applicazione Web non 




mensionale, scritto in C++ e utilizzabile 
sia con questo linguaggio, sia con la tec- 
nologia .NET.Presenta le principali carat- 
teristiche di un motore professionale e 
vanta una notevole comunità di svilup- 
patori, con diversi progetti in attivo. 
Irrlicht ha tra i suoi pregi anche quello di 
potere utilizzare sia DirectX che OpenGL 
per cui diventa particolarmente adatto 
anche per lo sviluppo di giochi multipiat- 
taforma 
irrlicht/irrlicht- 1 . 2.zip 



CRYSTAL SPACE LO 

IL RE C'È ANCORA 

E' stato per lungo tempo il dominatore 
delle scene per quanto riguarda gli 
Engine 3D. Lo è stato almeno fino all'av- 
vento di Irrlicht e del più recente XNA. 
Questo non vuol dire che non rappresen- 
ti ancora lo stato dell'arte nel campo della 




programmazione dei videogiochi. Ad 
oggi si tratta di uno degli engine 3D che 
conta il maggior numero di installazioni e 
giochi sviluppati. In questo numero vi 
presentiamo la release 1.0 di cui purtrop- 
po sono disponibili solo i sorgenti. 
Tuttavia la compilazione non è un'opera- 
zione complicata e vi mette in grado di 
conoscere ancora meglio il prodotto su 
cui state lavorando 
crystalspace/crystalspace-src-1.0.1 
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DEV C++ 4.9.9.2 

UN EDITOR C++ A BASSO COSTO 

Dev C++ è un editor distibuito su licenza 
GPL, come tale non ha costi relativi al 
diritto d'autore. Come tutto o quasi il 
software GPL la sua economicità non è 
affatto sinonimo di scarsa qualità. Al con- 
trario DEV C++ è uno degli editor C++ più 
amati ed utilizzati da chi sviluppa in C++. 
Le caratteristiche sono notevoli. Si va dal 
debugger integrato, al project manage- 
ment, al class browser, al code comple- 
tion. L'insieme di queste caratteristiche 
unite all'eccezionale leggerezza dell'am- 
biente lo rende particolarmente comodo 
da utilizzare per sviluppare progetti C++ 
anche di grandi dimensioni 
devcpp/devcpp-4.9. 9. 2 setup.exe 

JAVA SE 
DEVELOPMEIMT 
KIT 6 

IL COMPILATORE INDISPENSABILE 
PER PROGRAMMARE IN JAVA 

Se avete intenzione di iniziare a program- 
mare in Java oppure siete già dei pro- 
grammatori esperti avete bisogno sicura- 
mente del compilatore e delle librerie 
Java indispensabili. Sotto il nome di Java 
SE Development Kit vanno appunto tutti 




gli strumenti e le librerie nonché le utility 
necessarie per programmare in JAVA. 
L'attuale versione è la 6.0, ovvero la nuo- 
vissima release densa di innovazioni e 
molto più legata al desktop di quanto non 
fossero tutte le precedenti 
j2se/jdk-6-windows-i586.exe 

ECLIPSE SDK 3.2.2 

L'IDE TUTTOFARE 

Eclipse è un progetto completo portato 
avanti da Eclipse Foundation con la colla- 
borazione di una miriade di aziende fra 
cui IBM, Adobe, Sun e che si è prefissata 
lo scopo di creare un IDE estendibile per 
plugin adattabile a qualunque tipo di lin- 



guaggio o tecnologia. Di default Eclipse si 
propone come IDE per Java ed è qui che 
da il meglio di se. Ma proprio grazie ai 
suoi plugin è possibile utilizzarlo come 
ambiente di programmazione per PHP 
per C++, per Flex e per molti altri linguag- 
gi ancora. Inoltre sempre grazie per cia- 
scun linguaggio sono disponibili altri 
plugin ad esempio per rendere l'ambien- 
te RAD o per favorire lo sviluppo dei Web 
Services o altro. Insomma lo scopo è stato 
raggiunto completamente. Eclipse è real- 
mente un IDE tuttofare, ormai maturo, e 
che serve una miriade di programmatori 
grazie alle sue caratteristiche di affidabi- 
lità e flessibilità. Unica nota negativa: una 
certa pesantezza che lo rende idoneo ad 
essere usato solo su PC con una dotazio- 
ne hardware minima di tutto rispetto 
eclipse/eclipse-SDK-3. 2. 1-win32.zip 



PHP 5.2.1 

IL LINGUAGGIO DI SCRIPTING PIÙ 
AMATO DEL WEB 

Sono tre le colonne portanti di Internet: 
PHP APACHE e MySQL. Certo la concor- 
renza è forte. Asp.NET e SQL Server avan- 
zano con celerità, ma a tutt'oggi non si 
può affermare che i siti sviluppati in PHP 
costituiscano la stragrande maggioranza 
di Internet. Quali sono le ragioni del suc- 
cesso di cotanto linguaggio? Prima di 
tutto la completezza. PHP ha di base tutto 
quello che serve ad un buon programma- 
tore, raramente è necessario ricorrere a 
librerie esterne, e quando è proprio indi- 
spensabile farlo esistono comunque una 
serie di repository che rendono tutto 
immediatamente disponibile ed in forma 
gratuita. Il secondo punto di forza del lin- 
guaggio sta nella sua capacità di poter 
essere utilizzato sia in modo procedurale 
che nella sua forma ad oggetti certamen- 
te più potente e completa. Esiste un terzo 
di punta di forza essenziale che è quello 
riguardante la curva di apprendimento. 




PHP è in assoluto uno dei linguaggi con la 
curva di apprendimento più bassa nel 
panorama degli strumenti di program- 
mazione. Si tratta perciò di uno strumen- 
to indispensabile per chi si avwicina alla 
programmazione web, a meno che non 
intendiate scegliere strade diverse quali 
possono essere ASP.NET o JSP 
php/php-5.2. 0-Win32.zip 



STRUTS 2.0.1 

IL FRAMEWORK MVC PER JAVA 

Il pattern MVC è probabilmente il piùu- 
sato da tutti gli sviluppatori in ogni lin- 
guaggio.Questo framework è il leader per 
quanto riguarda lo sviluppo di applica- 
zioni Java secondo il pattern MVC. Molto 
comodo, stabile e affidabile, rappresenta 
la base di partenza per applicazioni che 
devono essere facilmente manutenibi- 
li.Uno standard da usare se progettate 
applicazioni di dimensioni generose, ma 
anche quando si sviluppano web applica- 
tion professionali 
struts/struts-2 .0. 1 -al l.zip 




TOMCAT 6.0.9 

IL SERVLET CONTAINER PER JAVA 
E JSP 

L'idea è molto semplice. Sviluppare im 
Java pagine Web. Ad un primo sguardo, 
Tomcat potrebbe sembrare un normale 
Web Server. Ed in effetti è un normale 
Web Server! In grado di soddisfare le 
richieste per qualunque pagina HTML. In 
realtà però Tomcat è anche qualcosa in 
più, ovvero la capacità di soddisfare le 
richieste per applicazioni Java. Potrebbe 
sembrare complesso, in realtà lo è meno 
di quanto sembri. Immaginate Tomcat 
come un grande contenitore al cui inter- 
no ci sono altri contenitori ciascuno dei 
quali rappresenta un'applicazione Java, 
che una volta richiamata costruisce una 
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SOFTWARE SUL CD 



Librerie e Tool di sviluppo 



pagina Web interpretabile da un browser. 
Questo consente di sviluppare pagine 
Web utilizzando tutta la potenza della 
normale gerarchia delle classi Java e la 
sintassi e il linguaggio che qualunque 
programmatore Java conosce bene. 
tomcat/apache-tomcat-6.0. 9.exe 



ZEND FRAMEWORK 
0.9 

L'SDK EVOLUTO PER PHP 

Chi sviluppa in PHP è abituato a svilup- 
pare in maniera autonoma il proprio fra- 
mework, partendo dalle proprie espe- 
rienze e necessità. Questo ha però dato 
origine ad un ecosistema di applicazioni 
spesso difficilmente manutenibile. Zend 
ha sviluppato un proprio Framework 
completo che dispone di una serie di 
meccanismi che velocizzano la risoluzio- 
ne dei problemi più frequenti. Si va dal- 
l'implementazione del pattern MVC alla 
creazione dei Web Services, alla gestione 
delle stampe in PDF. Si tratta di un fra- 
mework piuttosto affidabile essendo svi- 
luppato da Zend che è anche la software 
house promotrice dello sviluppo di PHP 
zendframework/ZendFramework-0.9.1- 
Beta 



lo sviluppo internet esistente, a dispetto 
di molti colosssi dell'informatica che 
operano in questo campo ed a testimo- 
nianza della grande maturità che questo 
linguaggio ha raggiunto. La sintassi è 
semplice, il linguaggio elegante, comple- 
to e particolarmete versatile, la curva di 
apprendimento molto bassa. Si tratta di 
uno strumento rapido che può coadiuva- 
re lo sviluppo tradizionale e perché no? in 
molti casi sostituirlo. In questo numero di 
ioProgrammo ve lo presentiam nella sua 
versione per .NET, particolarmente otti- 
mizzato per Windows. 
Ruby.NET.betaO. 5.bin. zip 



PYTHON 2.5 

L'EX GIOVANE RAMPANTE 

Python è stato considerato per lungo 
tempo il nuovo che avanza. 
Attualmente non lo si può più definire 
in questo modo, Python è ormai un lin- 
guaggio stabile e completo che trova 
applicazione inun gran numero di pro- 
getti. Se ne parla sempre di più in 
campo industriale come su Internet. 




RUBY.NET BETA 5 

IL NUOVO CHE AVANZA 

Ruby, probabilmente lo conosce tutti. E' 
un linguaggio nato ormai da una decina 
d'anni inizialmente con la pretesa di 
essere uno strumento matematico dalle 
caratteristiche avanzate. Nel tempo si è 
evoluto e migliorato fino a raggiungere 
oggi una piena maturità che lo colloca fra 
i linguaggi più usati dell'ultimo anno. 
Proprio uno dei framework più noti sul 
web: Ruby On Rails ha vinto l'anno scor- 
so il premio come miglior framework per 



Soprattutto un gran numero di applica- 
zioni anche in ambiente Windows gira- 
no ormai grazie a Python e presentano 
interfacce grafiche ottimamente strut- 
turate. Ciò nonostante Python rimane 
un grande linguaggio di scripting adat- 
to a gestire in modo completamente 
automatico buona parte di un sistema 
operativo sia esso Linux o Windows 
python/python-2.5.msi 



MYSQL 5.1.15 

IL PRINCIPE DEI DATABASE 

|Indispensabile per programmare 
webapplication in tecnologia PHP. 
Nonché non sia possibile utilizzare 
altridatabase, ma MySQL e PHP rappre- 



sentano veramente un binomioinscin- 
dibile. L'integrazione fra questo data- 
base e il linguaggio di scripting più 
usato sulla rete è talmente alta da fare 
divenire quasi un obbligo l'uso con- 
giunto di questi due strumenti 
Directory/mysql-5. 0.27-win32.zip 

FIREBIRD 

2.0.0.12748-0 

IL DATABASE VELOCE COME UN 
FULMINE 

Ha attraversato una serie incredibile di 
disavventure. Acquistato da Borland è poi 
tornato ad essere OpenSource. Presente 
sul mercato da tempo immemorabile è 
riuscito a sopravvivere alle sue varie vicis- 
situdine solo grazie alle sue grandi doti 
tecniche. E' un database velocissimo e 
ultraleggero, dotato però di tutte le fun- 
zioni di un server professional 
Firebird/Firebird-2.0.0. 12748-0- 
Win32.exe 

POSTGRES 8.2.3 

IL GRATIS COMPLETO E VELOCE 

Nessun server di database offre la com- 
pletezza delle funzioni esposte da 
PostgreSQL e rimane comunque com- 
pletamente Gratis. PostgreSQL è proba- 
bilmente il più estendibile fra i databa- 
se esistenti. Inutileparlare della gamma 
praticamente completa delle sue fun- 
zioni. Il punto di forza che lo pone pro- 
babilmente al di sopra di tutti i concor- 
renti rimane l'alta possibilità di perso- 
nalizzazione, oltre, naturalmente, alla 
velocità, alla stabilità ed al costo 
nullo.Unica pecca, una certa comples- 
sità nella gestione. E' sicuramente da 
usare in ambienti di produzione profes- 
sionali che non possono accontentarsi 
di alcun compromesso 
postrgresql/postgresql-8.2.1-1.zip 
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AUTOMI CELLULARI: 
IL GIOCO DELLA VITA 

TRA GLI AUTOMI CELLULARI, IL PIÙ NOTO È PROBABILMENTE IL GIOCO DELLA VITA. 
UN SEMPLICE E BEN STRUTTURATO ESEMPIO DI SISTEMA AUTO-ORGANIZZATO UTILE 
PER COMPRENDERE MOLTI FENOMENI ANCHE NATURALI 



Per programmatore il primo approccio con il 
gioco della vita o come è meglio conosciuto 
con "the game of life" o semplicemente "life" 
è spesso un esercizio per approfondire i dati struttu- 
rati omogenei bidimensionali. È un'infallibile stru- 
mento nelle mani del docente che riesce ad attrarre 
lo studente con un gioco per trasmette il fondamen- 
tale concetto di matrice. Il termine "gioco" non deve di- 
stogliere né sminuire la valenza di questo importan- 
te progetto, poiché grazie a life e ad alcune sue varianti 
è stato possibile studiare alcuni fenomeni naturali e 
sociali. Come vedremo, la molteplicità di configura- 
zioni che si possono ottenere e che spesso producono 
risultati grafici sorprendenti ha stimolato lo spirito 
"artistico" di molti programmatori o semplicemente ap- 
passionati che si sono avvicinati a questo mondo. In- 
somma, un modo stimolante per trattare i sempre più 
diffusi automi cellulari. In questo articolo presenterò 
a partire dalle regole del gioco tutto ciò che serve per 
realizzare un programma per computer utile a svi- 
lupparlo. Inoltre, osserveremo del software libero già 
pronto per trattare life ed esploreremo, infine, alcune 
interessanti varianti del gioco. 



DAGLI AUTOMI 
CELLULARI A LIFE 

life, anche se così definito, non è un gioco nel senso co- 
mune che attribuiamo alla parola. Sicuramente ha i 
suoi aspetti ludici e ricreativi ma presenta alcune pe- 
culiarità molto simili anche ad altri campi che non 
siano quelli del gioco. Si tratta di un automa cellulare. 
Brevemente, ricapitolando cosa è un automa cellula- 
re, visto che è stato il protagonista dell'ultimo appun- 
tamento di soluzioni. È un sistema ideato da uno de- 
gli studiosi più quotati del secolo nonché il padre del 
computer, mister John Von Neumann. Esso prevede 
un campo di celle generalmente disposte su uno spa- 
zio bidimensionale, in modo da definire una sorta di 
griglia. Le celle possono trovarsi in due stati, riconosciuti 
come vivo o morto (acceso o spento o ancora come 
zero o uno) . Attraverso regole di riproduzione che ten- 



gono conto dello stato di ogni singola cella, rispetto a 
quello del suo intorno, viene esaminata l'evoluzione 
della popolazione nel tempo. Per questo si tratta di un 
sistema miniaturizzato che simula la vita artificiale. 
Ed anche se le regole di produzione sono poche e gli 
stati di ogni singola cella sono soltanto due, è stato di- 
mostrato come sia complesso studiare l'evoluzione 
della popolazione, e come si possano innescare ele- 
menti di riproduzione inaspettati. 
Le regole di evoluzione, insieme al numero di stati di 
una cella e alle caratteristiche del campo definiscono 
diversi tipi automi cellulari. Quello che intendiamo 
sottoporre alla nostra lente di ingrandimento è stato 
proposto da uno dei più estrosi matematici di fine se- 
colo che più volte abbiamo incrociato nelle nostre 
analisi, si tratta di John Horton Conway. È stato lui ad 
introdurre "the game of life". Ma il risalto internazio- 
nale e la divulgazione alla platea scientifica e dei pro- 
grammazioni è dovuta ad un'altra nostra conoscen- 
za Martin Gardener che presentò gli studi di Conway 
in un memorabile articolo dell'ottobre del 1970 nella 
prestigiosa rivista Scientific American (si veda box "Li- 
fe su web"). Come lo stesso Gardener qualche anno 
dopo ricorderà, suo articolo rese popolare life ma fu 
anche un essenziale propulsore per la divulgazione 
degli automi cellulari fino a quel momento sottova- 
lutati. Sebbene la presentazione di Conway all'epoca 
era più associabile ad un solitario che alla simulazio- 
ne di un sistema evolutivo artificiale, presto le elabo- 
razioni al computer avrebbero aperto il viatico verso 
sempre più numerose e raffinate applicazioni basate 
su life. Infatti, vale la pena di ricordare che la prima 
formulazione era stata fatta con carta e penna ed i ra- 
ri elaboratori dell'epoca non venivano utilizzati per 
quelle che ancora sembravano applicazioni poco de- 
gne di automazione computerizzata. 



LE REGOLE 

È un gioco atipico poiché non sono presenti giocato- 
ri né tantomeno ci sono vincitori o perdenti. Si tratta 
di vedere come una configurazione iniziale (pattern) 
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di organismi sistemati su una griglia evolva nel tempo. 
Ed è proprio questo che diverte, la pratica di stabilire 
dei pattern che diano vita a popolazioni che hanno 
qualche motivo di interesse nella loro evoluzione tem- 
porale. Gli organismi, o usando il lessico più naturale 
degli automi cellulari: cellule o celle, possono trovar- 
si soltanto i due stati, vivo o morto. Lo stato di vita vie- 
ne evidenziato e marcato sulla cella. La griglia è bidi- 
mensionale ed è fatta di tante celle come una scac- 
chiera che però non ha, almeno teoricamente, limiti. 
Ogni cella ha un intorno di altre otto celle (intorno di 
Moore) . Le regole di riproduzione che descrivono l'e- 
voluzione sono state pensate da Conway per evitare que- 
sto processo in due situazioni estreme ma opposte ri- 
tenute negative e non naturali: il sovraffollamento e 
la solitudine. Non che le regole proposte siano del tut- 
to naturali come vedremo! Le leggi di evoluzione del- 
la popolazione sono: 

1 . Una cella viva che ha due o tre vicini vivi alla gene- 
razione successiva risulterà ancora viva. 

2. Una cella non in vita (o morta) nascerà alla gene- 
razione successiva se ha esattamente tre celle adia- 
centi vive; 

3. Una cella viva che non si trova nella situazione 1 o 
2, ossia non ha esattamente due o tre vicini vivi al- 
la prossima generazione morirà. In particolare: 

a. Una cella viva che non ha alcun vicino o che ne ha 
al più uno nella prossima generazione morirà per 
solitudine. 

b. Una cella viva che abbia quattro o più vicini nella pros- 
sima generazione morirà per sovraffollamento. 

Tutte le nascite e le morti prendono posto esattamente 
nello stesso istante, cosicché le celle morenti non pos- 
sono partecipare alla nascita di altre celle (nello stato 
di morte) . Così le celle che stanno nascendo non pos- 
sono partecipare, nello stato di vive alla morte di al- 
tre celle. È questo l'aspetto di sistema discreto che 
esprime Life. Si tratta cioè di un sistema che evolve a 
"scatti" in fissati istanti di tempo, ad esempio ogni se- 
condo. In figura 1 è riportato un semplice esempio che 
riporta l'evoluzione di una popolazione inizialmente 
costituita da quattro celle per quattro generazioni. 




Fig. 1: "L'evoluzione di un pattern iniziale (1) per quattro diverse generazioni. 
La generazione (2) vede sopravvivere tutte le celle tranne la più esposta in alto a 
sinistra che muore per solitudine, inoltre in basso a destra si registra una nascita. 
La generazione tre (3) a partire dalla due (2) vede le celle centrali perire per 
sovraffollamento mentre si verificano nuove nascite. E cosi si prosegue. 



MAX E I SUOI AMICI 



so (le configurazioni iniziali di celle vive) che termi- 
nali forme a cui si riducono le configurazioni; al fine di 
comprendere più facilmente come possa avvenire l'e- 
voluzione. Vi sono ad esempio delle configurazioni 
che oscillano continuamente come il caso della figu- 
ra 2. 



Fig. 2: 
"Esempio di 
oscillazione 
continua tra 
le due confi- 
gurazioni pro- 
poste" 



È stato Weisstein che ha classificato tutti i possibili 
modi in cui si può ridurre una in modo stabile popo- 
lazione dopo il naturale processo evolutivo, ossia in 
modo che rimanga tale se non influenzata da altre cel- 
le che nell'intorno mutano. Il principale esempio è il 
blocco, quattro celle vive disposte in quadrato figura 
3. Come si può notare sopravvivono tutte ma non dan- 
no origine a riproduzione. 



* * * 

r ::_H 



* * * 

=1 ' : 1 



Fig. 3: "Schemi terminali stabili (1) block o blocco e 
(2) tube o tubo 

Tutte gli altri schemi di Weisstein sono riportati in fi- 
gura 4. Sono stati estratti da mathworld.wolfram. 
Colui o ciò che vedete in figura 5 è invece Max, un 
misto tra uno spaventa passeri e un terminator, è un 
importante schema da cui partire per ottenere un tas- 
so di crescita della popolazione quadratico. Dopo la 
classificazione degli schemi terminali si passa a quel- 
la degli schemi iniziali o pattern che producono evo- 



Lo stato dell'arte e cosi avanzato a riguardo che si so- 
no classificati alcuni schemi sia per avviare il proces- 



bìock 

■■ 
■■ 



fKfi 

■ 

■ ■ 
■ 



hoc; 



snake shìp aircraft carrier beehive barge 



Python long boat eater, fìshhook loaf 



Fig. 4: "Insieme completo degli schemi terminali sta- 
bili proposti da Weisstein" 
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luzioni degne di essere osservate. Ad esempio, Max ha 
registrato l'importante risultato di crescere in modo 
quadratico, cosa che inizialmente si pensava impossibile. 
Il primo ad ottenere tale risultato fu Gosper con "bree- 
der", che lavorava lasciando dietro di sé una coda di gun. 
Da allora sono state prodotti complessi schemi, tra cui 
porte logiche per glider, un sommatore, un generato- 
re di numeri primi, e una cella che emula lo stesso Ga- 
me of Life scalato nello spazio e nel tempo. Molti di 
questi schemi sono presentati nel software descritto nel 
paragrafo successivo. 




Fig. 5: "Il pattern Max che descrive un tasso di cre- 
scita quadratico" 



SOFTWARE E 

IMPLEMENTAZIONE 

Sviluppare un programma che realizzi il gioco 
della vita è un compito che può essere svolto a 
diversi livelli. Si parte come detto con un eserci- 
zio che il professore dà per far comprendere le 
matrici e si arriva a sofisticate applicazioni che ge- 
stiscono tutte le possibili regole e varianti del 
gioco e curino al meglio la rappresentazione gra- 
fica. Parliamo prima della seconda categoria. Si 
tratta di software sviluppati un po' per passione 
e un po' per scopi professionali che realizzano 
in molti aspetti ed efficientemente il gioco della 
vita. Molti esempi si trovano sul web dove sono 
riportate delle applicazioni come applet java che 
simulano al meglio il gioco. Tra queste (come se- 
gnalate nel box life su web) divertenti sono i life 
colorati. In giro per il web si trova anche molto 
software free che fornisce ben fatte applicazioni 



stand alone. La più nota, che troverete anche su 
CD, è life 32 che permette di produrre facilmen- 
te dei pattern e di provarli sia a passi che in mo- 
do fluido. In questa seconda modalità è possibi- 
le stabilire il tempo di transizione tra una gene- 
razione e l'altra. In figura 6 è riportato una cat- 
tura dell'applicazione in esecuzione. 



BLifs32-[Hax.li|i , □ !.:~:.i 


-fero E±l . 


olay^dimo Ht» +■ 


= #bémi%<? e 


ffilSWx 


È"" 


r Enable torus 
















Top AÌJ-2M 
















Left <jj]-30( 










Width O^|601 




Heìght V^j401 














ff Snapto srnall 


sei. Il 


:: -'-± 




















l 


J 




- 1 


Tri 








O v H \Sheetl/Sheet2^Sheet3/ [ * 


ihT 


||Gen:22 |Cells: 12 X; -47 |Y:-9 Rute:M:s23/b3 ±50 \%\ 



Fig. 6: "Life 32 in esecuzione" 



Life32 permette di salvare e ovviamente caricare dei 
pattern in modo da lavorare anche in diversi momenti 
su uno stesso progetto. Si trovano infatti, sempre su 
internet collezioni di pattern, sul Cd ne è stata carica- 
ta una completa. Infine, ma non per ultima, infatti il 
software descritto e da provare e scoprire tante sono le 
funzioni e parametri che è possibile settare, segnalo 
la possibilità di cambiare le regole andando a specifi- 
care in modo semplice le richieste di sopravvivenza e 
di nascita, in termini di celle adiacenti (Figura 7) 
Come si può vedere si possono produrre sistemi che in- 
nescano comportamenti estremamente caotici come 
sistemi che registrano evoluzioni che si consumano 
nel giro di pochissime generazioni. Nel paragrafo suc- 
cessivo vi è un cenno delle varianti che si possono pro- 
durre. 
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Fig. 7: "Life 32 in configurazione delle regole (file>rules)" 



Se invece di essere utilizzatori vogliamo più op- 
portunamente essere programmatori, dobbia- 
mo realizzare un progetto che preveda un'ade- 
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guata struttura dati e una serie di routine in gra- 
do di comandare le richieste essenziali del gioco. 
La struttura che meglio si presta ad essere usata 
è certamente una matrice che sarebbe sufficiente 
se di booleani. Ma per prevedere varianti e life 
colorati e meglio predisporla di numeri interi; 
sia mappa tale variabile. Ogni cella, per la ver- 
sione originale, può valere ad esempio se mor- 
ta e 1 se viva. Una programma a livello didatti- 
co può essere così strutturato: 

_^{ 

// inizializzazione e configurazione della mappa 

configura(mappa); 

visualizza(mappa); 

do 



inìzializza(nuovamappa); 



for (1=1; i<m; i++) 



for (j = l; j<n; j++) 



switch (contavicini(mappa,i,j)) 



{case 0,1,4,5,6,7,8 : nuovamappa[i,j]<-false; 

// morte 
case 2: nuovamappa[i,j]<-mappa[i,j]; 
case 3: nuovamappa[i,j]<-true //vita 



}; 



copia(nuovamappa, mappa); 



visualizza(mappa); 



cout("Vuoi visionare altre generazioni (S/N)"); 



leggi(risp); 



while (risp='N'); 



}■■■ 



Ovviamente, si tratta di una versione basic in cui 
tutte le operazioni di configurazione e inizializ- 
zazione della mappa avvengono in sequenza. 
Inoltre è poco personalizzabile se non manipo- 
lando il codice. Nell'implementare le routine si 
possono introdurre elementi di grafica come per 
la visualizzazione della mappa che in questo ca- 
so risulta sicuramente più gradevole. Interes- 
sante a scopo didattico è contavicini sviluppata 
per l'intorno di moore 

Int contavicini(matrice mat; int riga, colonna); 

{ intij; 

// Inizializza il contatore 

int Conta = 0; 

// Esplora tutti i vicini 

for ( i = riga-l;i<riga+l; i+ + ) 

for ( j= colonna-I; j<colonna + l; j++) 

if ((i>0) and (j>0) and (i<m+l) and (j<n+l)) 
if (mat[i,j] = = l) then conta+ + 
return conta 
} 

Andrebbe ottimizzato il funzionamento a bordo 
mappa. 



IL MONDO 
DELLE VARIANTI 

Nel corso degli anni sono state introdotte varianti al- 
l'idea originaria. Nella versione originale, un organismo 
nasce se ha esattamente tre organismi vivi vicini, so- 
pravvive se ne ha 2 o 3, e muore altrimenti, ciò è sim- 
bolizzato con "s23/b3". Il primo numero, o lista di nu- 
meri, dopo la lettera s indica le richieste per la so- 
pravvivenza (survival). Il secondo numero o lista di 
numeri, dopo la lettera b rappresenta le regole per la 
nascita (b come birth). Ad esempio "s25/b4" signifi- 
ca "un organismo nasce se ha 4 vicini vivi, e sopravvi- 
ve se ne ha 2 o 5, muore altrimenti. HighLife è 23/36: 
in aggiunta alle regole originali 6 vicini comportano 
una nascita. HighLife è particolarmente conosciuto 
per i suoi replicanti. Su una discussione dell'enciclo- 
pedia libera sul web WiMpedia sono state catalogate con 
cura una numerosa serie di altre possibilità. Anche se, 
come sottolinea l'autore la maggioranza di questi uni- 
versi alternativi è troppo caotica o troppo desolata. 
Eccoli: 

s/b3 (stabile) quasi ogni cosa è una scintola 
s5678/b35678 (caotico) diamanti, catastrofi 
s/b2 (esplosivo) "Seeds" phoenix, minimale 
s/b234 (esplosivo) phoenix, lacey patterns 
sl2345/b3 (esplosivo) schemi labirintici 
sl25/b36 (caotico) blocchi 2x2 simili all'originale 
sl357/bl357 (esplosivo) tutto è un replicante 
sl358/b357 (caotico) un'ameba bilanciata 
s23/b3 (caotico) "Conway'sLife" 
s23/b36 (caotico) "HighLife" (ha replicanti) 
s235678/b3678 (stabile) macchie d'inchiostro che 
si asciuga subito 

s235678/b378 (esplosivo) coagulazioni nel caos 
s238/b357 (caotico) brokenlife 

Fonte per questa lista di regole: Life32 

Altre variazioni si basano sulla modifica di altri ele- 
menti del gioco, come la dimensionalità del campo, 
che può essere a una come a tre dimensioni, o lo sta- 
to dei singoli organismi che può appartenere a più di 
due stati. In questo ultimo caso si da origine a Life co- 
lorati (un colore diverso per ogni stato) che produco- 
no evoluzioni temporali spesso molto affascinanti an- 
che da un punto di vista grafico. Oltre alla dimensio- 
nalità anche la forma della cella può dare origine a 
nuove varianti, ed ecco che ad esempio rispunta la 
struttura di Hex un gioco di strategia esaminato in pas- 
sato tra queste pagine in cui la singola cella è un esa- 
gono. Qui il concetto di adiacenza è più naturale vi- 
sto che ogni cella è esattamente confinate con sei al- 
tre sei, con ognuno dei sui lati; non come l'intorno di 
moore per celle quadrate dove alcune adiacenze si 
hanno per un solo punto. 

Fabio Grimaldi 
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